From FreeCAD Documentation
Jump to navigation Jump to search



You can install FreeCAD on Windows by downloading one of the installers below:

Windows.png Windows 32 bit (sha256)

Windows.png Windows 64 bit (sha256)

After downloading the .exe (NSIS Installer) file, double-click on it to start the installation process.

Below is more information about some technical options. Nevertheless, most users don't need more than the above .exe files. Head to Get started after installation is complete.

Simple NSIS Installer Installation

The easiest way to install FreeCAD on Windows is by using the downloadable installer bundle above. This page describes the usage and features of the NSIS Installer for more installation options.

If you would like to download a development version (which may be unstable), see the Download page.


However, it is highly recommended that you use a package manager such as Chocolatey to keep your software updated. You can installed Chocolatey following these instructions and then open a PowerShell terminal as admin and run:


choco install freecad


every once in a while you can update your software with


choco upgrade freecad


to get the latest version available on Chocolatey repository. If there are any issues with the chocolatey package, you may contact maintainers on this page.

Command line installation

With the msiexec.exe command line utility, additional features such as non-interactive installation and administrative installation are available. See examples below.

Non-interactive installation

With the command line


msiexec /i FreeCAD<version>.msi


installation can be initiated programmatically. Additional parameters can be passed at the end of the command line, for example


msiexec /i FreeCAD-2.5.msi TARGETDIR=R:\FreeCAD25


Limited user interface

The amount of user control permitted by the installer can be controlled with /q options:

  • /qn - No interface
  • /qb - Basic interface - display only a progress dialog with Cancel button
  • /qb! - Like /qb, but hide the Cancel button
  • /qr - Reduced interface - display all dialogs that do not require user interaction (skip all modal dialogs)
  • /qn+ - Like /qn, but display "Completed" dialog at the end
  • /qb+ - Like /qb, but display "Completed" dialog at the end

Target directory

The property TARGETDIR determines the root directory of the FreeCAD installation. For example, a different installation drive can be specified with




The default TARGETDIR is [WindowsVolume\Programm Files\]FreeCAD<version>.

Installation for All Users





causes an installation usable by all users. By default, a non-interactive (/i) installation makes the package usable by the current user (the one performing the installation) only; an interactive installation presents a dialog which defaults to "all users" if the user performing the installation is sufficiently privileged.

Feature Selection

A number of properties allow selection of features to be installed, reinstalled, or removed. The set of features for the FreeCAD installer is

  • DefaultFeature - install the software proper, plus the core libraries
  • Documentation - install the documentation
  • Source code - install the sources
  • ... ToDo

In addition, ALL specifies all features. All features depend on DefaultFeature, so installing any feature automatically installs the default feature as well. The following properties control features to be installed or removed

  • ADDLOCAL - list of features to be installed on the local machine
  • REMOVE - list of features to be removed from the local machine
  • ADDDEFAULT - list of features added in their default configuration (which is local for all FreeCAD features)
  • REINSTALL - list of features to be reinstalled/repaired
  • ADVERTISE - list of features for which to perform an advertise installation

There are a few additional properties available; see the MSDN documentation for details.

With these options, adding




installs the interpreter itself and registers the extensions, but does not install anything else.




msiexec /x FreeCAD<version>.msi


FreeCAD can be uninstalled. It is not necessary to have the MSI file available for uninstallation; alternatively, the package or product code can also be specified. You can find the product code by looking at the properties of the Uninstall shortcut that FreeCAD installs in the start menu.

Administrative installation



msiexec /a FreeCAD<version>.msi


an "administrative" (network) installation can be initiated. The files get unpacked into the target directory (which should be a network directory), but no other modification is made to the local system. In addition, another (smaller) msi file is generated in the target directory, which clients can then use to perform a local installation (future versions may also offer to keep some features on the network drive altogether).

Currently, there is no user interface for administrative installations, so the target directory must be passed on the command line.

There is no specific uninstall procedure for an administrative install - simply delete the target directory if no client uses it anymore.



msiexec /jm FreeCAD<version>.msi


it would be possible, in principle, to "advertise" FreeCAD to a machine (with /ju to a user). This would cause the icons to appear in the start menu and the extensions to become registered, without the software actually being installed. The first usage of a feature would cause that feature to be installed.

The FreeCAD installer currently only supports advertisement of start menu entries, but no advertisement of shortcuts.

Automatic installation on a group of machines

With Windows Group Policy, it is possible to automatically install FreeCAD on a group of machines. To do so, perform the following steps:

  1. Log on to the domain controller
  2. Copy the MSI file into a folder that is shared with access granted to all target machines.
  3. Open the MMC snapin "Active Directory users and computers"
  4. Navigate to the group of computers that need FreeCAD
  5. Open Properties
  6. Open Group Policies
  7. Add a new policy, and edit it
  8. In Computer Configuration/Software Installation, choose New/Package
  9. Select the MSI file through the network path
  10. Optionally, select that you want FreeCAD to be de-installed if the computer leaves the scope of the policy.

Group policy propagation typically takes some time - to reliably deploy the package, all machines should be rebooted.

Installation on Linux using Crossover Office

You can install the windows version of FreeCAD on a Linux system using CXOffice 5.0.1. Run msiexec from the CXOffice command line. Assuming the install package is in the "software" directory on drive "Y:":


msiexec /i Y:\\software\\FreeCAD<version>.msi


FreeCAD is running, but it has been reported that the OpenGL display does not work, like with other programs running under Wine i.e. Google SketchUp.




The installation of FreeCAD on the most well-known Linux systems has been now endorsed by the community, and FreeCAD should be directly available via the package manager available on your distribution. The FreeCAD team also provides a couple of "official" packages when new releases are made, and a couple of experimental Personal Package Archive (PPA) repositories for testing bleeding-edge features.

Once you've got FreeCAD installed, it's time to get started!

Ubuntu and Ubuntu-based systems

Many Linux distributions are based on Ubuntu and share its repositories. Besides official variants (Kubuntu, Lubuntu and Xubuntu), there are non official derivatives like Linux Mint, Voyager and others. The installation options below should be compatible with these systems.

Official Ubuntu repository

FreeCAD is available from the Ubuntu Universe repository, and can be installed via the Software Center or from the terminal:


sudo apt install freecad


Note: the Ubuntu Universe package may be outdated as the packaging may lag behind the latest stable source code. In this case, it is suggested to install the package from the -stable PPA below. In addition, installing the -daily package can be done to test the development branch.

Stable PPA through the graphical interface

To install FreeCAD using the personal package archive (PPA) maintained by the FreeCAD project, please follow these instructions. The repository is called freecad-stable on Launchpad.

  • Navigate to Ubuntu Software → Software & Updates → Software Sources → Other Software
  • Click on And, then copy and paste the following line




  • Add the source, close the dialog, and reload your software sources, if asked.

Now you can find and install the last stable FreeCAD version from the Ubuntu Software Center.

Stable PPA through the console

  • Add the PPA to your software sources:


sudo add-apt-repository ppa:freecad-maintainers/freecad-stable


  • Retrieve the updated package lists:


sudo apt update


  • Then install FreeCAD along with its offline documentation:


sudo apt install freecad freecad-doc


Note: due to packaging problems, in certain versions of Ubuntu the freecad-doc package has collided with the installation of FreeCAD or one of its dependencies; if this is the case, remove the freecad-doc package, and only install the freecad package. If the freecad-doc package doesn't exist, then ignore it.

Once you have the stable PPA added to your sources, the freecad package will install this PPA version over the one provided by the Ubuntu Universe repository. You can see the available versions with apt-cache. </translate>

apt-cache policy freecad
  Installed: (none)
  Candidate: 2:0.18.4+dfsg1~201911060029~ubuntu18.04.1
  Version table:
     2:0.18.4+dfsg1~201911060029~ubuntu18.04.1 500
        500 bionic/main amd64 Packages
     0.16.6712+dfsg1-1ubuntu2 500
        500 bionic/universe amd64 Packages
ubuntu@ubuntu:~$ apt-cache policy freecad-doc


Run the stable (PPA) version of FreeCAD: </translate>



Daily PPA through the console

As FreeCAD is in constant development, you may wish to install the daily package to keep with the latest improvements and bug fixes. The repository is called freecad-daily on Launchpad.

This version is compiled daily from the official master repository. Please beware that although it will contain new features and bug fixes, it may also have newer bugs, and be unstable.

Add the daily PPA to your software sources, update the package lists, and install the daily package: </translate>

sudo add-apt-repository ppa:freecad-maintainers/freecad-daily
sudo apt-get update
sudo apt-get install freecad-daily

<translate> Every day you can update to the latest daily: </translate>

sudo apt-get update
sudo apt-get install freecad-daily


Note: in some cases new code or dependencies added to FreeCAD will cause packaging errors; if this happens, a daily package may not be generated until the maintainers manually fix the problems. If you wish to continue testing the latest code, you should get the source code and compile FreeCAD directly; for instructions see compiling.

Run the daily (PPA) version of FreeCAD: </translate>



Note: it is possible to install both the -stable and -daily packages in the same system. This is useful if you wish to work with a stable version, and still be able to test the latest features in development. Notice that the executable for the daily version is freecad-daily, but for the stable version it is just freecad.

Debian and other debian-based systems

Since Debian Lenny, FreeCAD is available directly from the Debian software repositories and can be installed via synaptic or simply with:


sudo apt-get install freecad



A vast release program for FreeCAD package builds are offered.

For installing of stable releases, please visit for a survey:

Survey of stable repositories on openSUSE

Generally for selecting the correct openSUSE distribution needed it is necessary to click on the particular view button.

The stable package version of FreeCAD could be found under:

Stable repositories on openSUSE

The correct openSUSE distribution version must be selected in the lower part of the web page.

FreeCAD is typically installed with YAST (abbr. Yet another Setup Tool) the Linux operating system setup and configuration tool, or in any terminal (root rights required) with:


zypper install FreeCAD


This procedure only covers the installation of officially released stable FreeCAD program versions, depending on the installed links to the program package repositories of your OS.

To check out the latest development releases (unstable) you have to visit:

Unstable repositories on openSUSE

It is recommended to grab the binary packages directly. Then select the correct distribution for your installed openSUSE OS.


FreeCAD can be built/installed simply by issuing:


emerge freecad



FreeCAD has been included in the official Fedora packages since Fedora 20. It can be installed from the command line with:


sudo dnf install freecad


On older Fedora releases, that was:


sudo yum install freecad


The gui packages managers can also be used. Search for </translate>"freecad".<translate>

The official release package version tends to be well behind the FreeCAD releases. Package: freecad shows the versions included in the Fedora repositories over time and versions.

More current versions can be obtained by downloading one of the </translate>.AppImage<translate> releases from the github repository. These work fine on Fedora.

If you want to keep up with the absolute latest daily builds, FreeCAD is also available on </translate>copr<translate> . To install the build from there, in a terminal session, enter:


sudo dnf copr enable @freecad/nightly
sudo dnf install freecad


That leaves the </translate>copr<translate> repository active, so


sudo dnf upgrade


or equivalent, will update to the latest FreeCAD build, along with updates from any of the other active repos. If you want something a bit more stable, you can disable </translate>@freecad/nightly<translate> again after the initial install. The </translate>copr<translate> repository only keeps builds from the past 2 weeks. This is not a solution if you want to pick a specific older version.

Instructions are also available on compile FreeCAD yourself, including a script specifically for Fedora. With a minor change, to checkout the specific commit from git, any version since about FreeCAD 0.15 can be built on any distribution since Fedora 21.


Installing FreeCAD on Arch Linux and derivatives (ex. Manjaro):


pacman -S freecad



If you find out that your system features FreeCAD but is not documented in this page, please tell us on the forum!

Many alternative, non-official FreeCAD packages are available on the net, for example for systems like slackware or fedora. A search on the net can quickly give you some results.

Manual install on .deb based systems

If for some reason you cannot use one of the above methods, you can always download one of the .deb packages available on the Download page.
Linux.png Ubuntu 32/64bit AppImage-logo.png AppImage 64bit

Once you downloaded the .deb corresponding to your system version, if you have the Gdebi package installed (usually it is), you just need to navigate to where you downloaded the file, and double-click on it. The necessary dependencies will be taken care of automatically by your system package manager. Alternatively you can also install it from the terminal, navigating to where you downloaded the file, and type:


sudo dpkg -i Name_of_your_FreeCAD_package.deb


changing Name_of_your_FreeCAD_package.deb by the name of the file you downloaded.

After you installed FreeCAD, a startup icon will be added in the "Graphic" section of your Start Menu.

Installing on other Linux/Unix systems

Many common Linux distros now include a precompiled FreeCAD as part of the standard packages. This is often out of date, but is a place to start. Check the standard package managers for your system. One of the following (partial) list of commands could install the official version of FreeCAD for your distro from the terminal. These probably need administrator privileges.


apt-get install freecad
dnf install freecad
emerge freecad
slackpkg install freecad
yum install freecad
zypper install freecad


The package name is case sensitive, so try `FreeCAD` as well as `freecad`. If that does not work for you, either because your package manager does not have a precompiled FreeCAD version available, or because the available version is too old for your needs, you can try downloading one of the </translate>.AppImage<translate> releases from the github repository. These tend to work on most 64 bit Linux distributions, without any special installation. Just make sure the downloaded file is marked as executable, then run it.

If that still is not good enough, and you can not locate another source of a precompiled package for your situation, you will need to compile FreeCAD yourself.

Installing Windows Version on Linux

See the Install on Windows page.




FreeCAD can be installed on macOS in on .dmg package which you can drag and drop into your Applications folder:

Stable.pngMac.png MacOS 10.11 El Capitan 64-bit (sha256)

and the nightly build can be downloaded from

Nightly.pngNightly 19_pre (sha256)

However, it is highly recommended to use a package manager such as HomeBrew to keep your software updated. Instructions to install HomeBrew can be seen here. When HomeBrew installed you can simply install FreeCAD through your bash terminal with


brew cask install freecad


and to upgrade the software to the latest version available on HomBrew Cask you may run


brew cask upgrade freecad


If there are any issues with the HomeBrew Cask formula you may report here.

This page describes the usage and features of the FreeCAD installer. It also includes uninstallation instructions. Once installed, you can get started!

Simple installation

The FreeCAD installer is provided as a app package (.app) enclosed in a disk image file.

You can download the latest installer from the Download page. After downloading the file, just mount the disk image, then drag it to the Application folder or a folder of your choice.

Mac installer 1.png

That's it.Just click on the app to launch FreeCAD. If you have this message "FreeCAD can't be open as it is from unidentified developer. " Open the folder (Application) and right click on the app then click open and accept to open the application.


There currently isn't an uninstaller for FreeCAD. To completely remove FreeCAD and all installed components, drag the following files and folders to the Trash:

  • In /Applications:
    • FreeCAD

That's it.