Known OS specific Issues

Post here for help on using FreeCAD's graphical user interface (GUI).
Forum rules
and Helpful information
IMPORTANT: Please click here and read this first, before asking for help

Also, be nice to others! Read the FreeCAD code of conduct!
Posts: 18029
Joined: Tue Mar 17, 2015 9:14 am

Known OS specific Issues

Postby chrisb » Wed Aug 29, 2018 6:38 am

This topic is locked. For comments go to

For modeling issues please refer to the FAQ and the Troubleshooting models
  • Ubuntu
    1. :bangbang: Ubuntu does not show *.FCStd files and does not use the file extension on saving
      This is an issue with the system file selection dialog. From another topic:
      wmayer wrote:
      Sun Jan 27, 2019 11:23 am
      The problem is somehow with the native file dialog on some DEs (Desktop Environments).
      The easiest would be to upgrade to v0.18 where we have added an option to change at
      runtime between the native and Qt file dialog.
      :ballot_box_with_check: Workaround:
      1. Open the Parameter editor from the Tools menu
      2. Navigate to BaseApp/Preferences/Dialog
      3. Create a boolean parameter named: DontUseNativeDialog and set it to true.
    2. :bangbang: Startup fails on Debian based system like Ubuntu, Debian, Mint, ...
      FreeCAD startup may fail with the message

      Code: Select all

      failed to create drawable
      [xcb] Unknown sequence number while processing queue
      [xcb] Most likely this is a multi-threaded client and XInitThreads has not been called
      [xcb] Aborting, sorry about that.
      freecad: xcb_io.c:259: poll_for_event: Assertion `!xcb_xlib_threads_sequence_lost' failed.
      :ballot_box_with_check: Workaround: Launch FreeCAD from the command line terminal:
      gntech wrote:
      Thu Apr 12, 2018 6:04 pm
      A workaround is to disable DRI3 just for FreeCAD by launching FreeCAD from the terminal with the following command.

      Code: Select all

      LIBGL_DRI3_DISABLE=true freecad
    3. :bangbang: Crash on Debian based systems importing SVG
      Hint from NormandC: The current PPAs fix this by upgrading some dependencies. Users who previously implemented Chris_G's fix mentioned below should revert the change (unlock the expat/libexpat1 packages and update them to the version in the Ubuntu 18.04/18.10 repo) for the PPA update to succeed.

      Outdated message:
      FreeCAD can crash when importing SVG files with a message like
      jalar wrote:
      Wed Jan 10, 2018 1:19 pm

      Code: Select all

      openat(AT_FDCWD, "/path-to-file.svg", O_RDONLY) = 27
      fstat(27, {st_mode=S_IFREG|0644, st_size=2234752, ...}) = 0
      --- SIGSEGV {si_signo=SIGSEGV, si_code=SEGV_MAPERR, si_addr=0x3a9} ---
      write(2, "\33[1;31m", 7)                = 7
      write(2, "Program received signal SIGSEGV,"..., 53Program received signal SIGSEGV, Segmentation fault.
      ) = 53
      #0  /lib/x86_64-linux-gnu<br />
      / [0x7fd97f382140]
      #1  /lib/x86_64-linux-gnu/ [0x7fd976c411cb]
      #2  /usr/lib/python2.7/lib-dynload/ [0x7fd90487a968]
      :ballot_box_with_check: Workaround: As a solution some libraries have to be installed manually:
      Chris_G wrote:
      Thu Apr 19, 2018 8:45 am
      The packages from Ubuntu xenial work fine :
      I have also this one, but I don't know if it is really needed :

      Then in the folder where you downloaded the packages :

      Code: Select all

      sudo dpkg -i ./expat_2.1.0-7ubuntu0.16.04.3_amd64.deb
      sudo echo expat hold | sudo dpkg --set-selections
      sudo dpkg -i ./libexpat1_2.1.0-7ubuntu0.16.04.3_amd64.deb
      sudo echo libexpat1 hold | sudo dpkg --set-selections
      sudo dpkg -i ./libexpat1-dev_2.1.0-7ubuntu0.16.04.3_amd64.deb
      sudo echo libexpat1-dev hold | sudo dpkg --set-selections
  • Windows
    1. :bangbang: The change from Qt4 to Qt5 can cause issues on Windows:
      wmayer wrote:
      Fri May 03, 2019 11:17 am
      The responsible change that could explain the behaviour is the move from Qt4 to Qt5. Qt5 has a module QtOpenGL kept for backward compatibility but it's recommended not to use it and instead to port old code to the new API. At the beginning when we moved to Qt5 we used this module but it caused several problems and we then ported our code using the recommended API.

      Under the hood the implementation of OpenGL support in Qt5 has changed a lot and it's hard to say what at the end is responsible if something doesn't work. But as said above in most cases it's the graphic driver that causes problems.
      For more information also have a look here: ... cs-drivers Maybe you can get it to work by setting the variable QT_OPENGL
      :ballot_box_with_check: Workaround: If you face weird behaviour concerning mouse movements, menus disappearing, black windows, try the Qt4 variant of the development version.
    2. :bangbang:Windows display driver
      There are issues with Radeon graphic cards. If your objects show transparency where they should not, it may be caused by the Radeon driver.

      :ballot_box_with_check: Workaround: Rollback to an earlier driver graphic card driver version.
      SirSpamalot wrote:
      Tue Aug 28, 2018 10:46 pm
      I have a Radeon RX 460 card. It appears that I updated the driver on July 23, 2018. The updated driver was version 24.20.12019.1010 (from Radeon Driver Package 18.7.1). I rolled it back to the version that was previously installed, 21.19.407.0, and that resolved the problem. I then rolled it forward to 24.20.11016.4 (from Radeon Driver Package 18.5.1) and I still don't have the problem. Yay!
      Here is another report of issues with a Radeon 5470 and a driver solving it: ... 44#p264835

      A user from the german forum has successfully installed the current driver version 18.12.2 including. Relive für his Radeon R9 380.

      Radeon Vega 64 is said to be working with driver version See ... 40#p281540
    3. :bangbang: Windows: screen going black
      This is again a display driver issue in connection with Qt5.
      :ballot_box_with_check: Workaround: Try a Qt4 version of Freecad from the development versions.
    4. :bangbang: FreeCAD doesn't start after install
      FreeCAD won't run in Windows 7 if you have "Classic View" enabled.

      :ballot_box_with_check: Workaround: According to this topic switching to the "Aero" theme helps.
    5. :bangbang: View keeps spinning and/or zooming
      :ballot_box_with_check: Workaround: Make sure you disconnect all additional devices, such as Joysticks. See
  • MacOS
    1. :bangbang: MacOS: freezing for about a minute on MacOS Mojave (10.14)
      Opening a system dialog on these systems can take extremely long.
      :ballot_box_with_check: Workaround: start FreeCAD from a console or batch file.

      See and ... 05#p329405 for details.
    2. :bangbang: MacOS Catilina (10.15)
      Sytem message “” can’t be opened because its integrity cannot be verified.

      :ballot_box_with_check: Workaround: According to this post the quarantine flag has to be removed:

      Code: Select all

      sudo xattr -d /Applications/