Difference between revisions of "Install on Linux"

From FreeCAD Documentation
Jump to navigation Jump to search
(Marked this version for translation)
Line 2: Line 2:
 
<translate>
 
<translate>
  
 +
<!--T:1-->
 
{{Docnav
 
{{Docnav
 
|[[Install on Windows|Install on Windows]]
 
|[[Install on Windows|Install on Windows]]
Line 7: Line 8:
 
}}
 
}}
  
==Overview==
+
==Overview== <!--T:2-->
  
 
</translate>
 
</translate>
Line 14: Line 15:
  
  
 +
<!--T:3-->
 
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 some:
 
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 some:
 
* "Official" packages when new releases are made
 
* "Official" packages when new releases are made
Line 21: Line 23:
 
<div class="mw-collapsible mw-collapsed toccolours">
 
<div class="mw-collapsible mw-collapsed toccolours">
 
<translate>
 
<translate>
==Ubuntu and Ubuntu-based systems==  
+
==Ubuntu and Ubuntu-based systems== <!--T:4-->
  
 +
<!--T:5-->
 
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.
 
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.
 
</translate>
 
</translate>
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
<translate>
 
<translate>
=== Official  ===
+
=== Official  === <!--T:6-->
  
 +
<!--T:7-->
 
FreeCAD is available from the Ubuntu Universe repository, and can be installed via the {{MenuCommand|Software Center}} or from the terminal:
 
FreeCAD is available from the Ubuntu Universe repository, and can be installed via the {{MenuCommand|Software Center}} or from the terminal:
  
Line 37: Line 41:
 
<translate>
 
<translate>
  
 +
<!--T:8-->
 
{{Emphasis|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 {{incode|-stable}} PPA below. In addition, installing the {{incode|-daily}} package can be done to test the development branch.
 
{{Emphasis|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 {{incode|-stable}} PPA below. In addition, installing the {{incode|-daily}} package can be done to test the development branch.
  
=== Stable PPA ===
+
=== Stable PPA === <!--T:9-->
  
 +
<!--T:10-->
 
Personal Package Archive (PPA) for the stable FreeCAD release is maintained by the FreeCAD community on on Launchpad. The Launchpad repository is called [https://launchpad.net/~freecad-maintainers/+archive/freecad-stable freecad-stable] .
 
Personal Package Archive (PPA) for the stable FreeCAD release is maintained by the FreeCAD community on on Launchpad. The Launchpad repository is called [https://launchpad.net/~freecad-maintainers/+archive/freecad-stable freecad-stable] .
  
==== GUI ====
+
==== GUI ==== <!--T:11-->
  
 +
<!--T:12-->
 
Install the stable PPA via the Graphical User Interface (GUI):
 
Install the stable PPA via the Graphical User Interface (GUI):
  
 +
<!--T:13-->
 
:1. Navigate to {{MenuCommand|Ubuntu Software → Software & Updates → Software Sources → Other Software}}
 
:1. Navigate to {{MenuCommand|Ubuntu Software → Software & Updates → Software Sources → Other Software}}
 
:2. Click on {{Button|And}}, then copy and paste the following line
 
:2. Click on {{Button|And}}, then copy and paste the following line
Line 55: Line 63:
 
<translate>
 
<translate>
  
 +
<!--T:14-->
 
:3. Add the source, close the dialog, and reload your software sources, if asked.
 
:3. Add the source, close the dialog, and reload your software sources, if asked.
  
 +
<!--T:15-->
 
Now you can find and install the last stable FreeCAD version from the {{MenuCommand|Ubuntu Software Center}}.
 
Now you can find and install the last stable FreeCAD version from the {{MenuCommand|Ubuntu Software Center}}.
  
==== CLI ====  
+
==== CLI ==== <!--T:16-->
  
 +
<!--T:17-->
 
Install the stable PPA via the Command Line Interface (CLI):
 
Install the stable PPA via the Command Line Interface (CLI):
  
 +
<!--T:18-->
 
:1. Add the PPA to your software sources:
 
:1. Add the PPA to your software sources:
 
</translate>
 
</translate>
Line 70: Line 82:
 
<translate>
 
<translate>
  
 +
<!--T:19-->
 
:2. Retrieve the updated package lists:
 
:2. Retrieve the updated package lists:
 
</translate>
 
</translate>
Line 77: Line 90:
 
<translate>
 
<translate>
  
 +
<!--T:20-->
 
:3. Then install FreeCAD along with its offline documentation:
 
:3. Then install FreeCAD along with its offline documentation:
 
</translate>
 
</translate>
Line 84: Line 98:
 
<translate>
 
<translate>
  
 +
<!--T:21-->
 
{{Emphasis|Note:}} due to packaging problems, in certain versions of Ubuntu the {{incode|freecad-doc}} package has collided with the installation of FreeCAD or one of its dependencies; if this is the case, remove the {{incode|freecad-doc}} package, and only install the {{incode|freecad}} package. If the {{incode|freecad-doc}} package doesn't exist, then ignore it.
 
{{Emphasis|Note:}} due to packaging problems, in certain versions of Ubuntu the {{incode|freecad-doc}} package has collided with the installation of FreeCAD or one of its dependencies; if this is the case, remove the {{incode|freecad-doc}} package, and only install the {{incode|freecad}} package. If the {{incode|freecad-doc}} package doesn't exist, then ignore it.
  
==== Checking Installation ====
+
==== Checking Installation ==== <!--T:22-->
  
 +
<!--T:23-->
 
:4. Once you have the stable PPA added to your sources using one of the above methods, the {{incode|freecad}} package will install this PPA version over the one provided by the Ubuntu Universe repository. You can see the available versions with the following {{incode|apt-cache}} command:
 
:4. Once you have the stable PPA added to your sources using one of the above methods, the {{incode|freecad}} package will install this PPA version over the one provided by the Ubuntu Universe repository. You can see the available versions with the following {{incode|apt-cache}} command:
 
</translate>
 
</translate>
Line 95: Line 111:
 
<translate>
 
<translate>
  
 +
<!--T:24-->
 
:The output should look similar to the following (of course the version info will vary):  
 
:The output should look similar to the following (of course the version info will vary):  
 
</translate>
 
</translate>
Line 110: Line 127:
 
<translate>
 
<translate>
  
 +
<!--T:25-->
 
:5. Invoke the stable (PPA) version of FreeCAD from the GUI or CLI. The latter method is as follows:
 
:5. Invoke the stable (PPA) version of FreeCAD from the GUI or CLI. The latter method is as follows:
 
</translate>
 
</translate>
Line 117: Line 135:
 
<translate>
 
<translate>
  
=== Development PPA (Daily) ===
+
=== Development PPA (Daily) === <!--T:26-->
  
 +
<!--T:27-->
 
As FreeCAD is in constant development, you may wish to install the {{Emphasis|daily}} package to keep with the latest improvements and bug fixes. The repository is also hosted on Launchpad and is called [https://launchpad.net/~freecad-maintainers/+archive/freecad-daily freecad-daily].
 
As FreeCAD is in constant development, you may wish to install the {{Emphasis|daily}} package to keep with the latest improvements and bug fixes. The repository is also hosted on Launchpad and is called [https://launchpad.net/~freecad-maintainers/+archive/freecad-daily freecad-daily].
  
 +
<!--T:28-->
 
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.
 
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.
  
 +
<!--T:29-->
 
Add the daily PPA to your software sources, update the package lists, and install the daily package:
 
Add the daily PPA to your software sources, update the package lists, and install the daily package:
 
</translate>
 
</translate>
Line 132: Line 153:
 
<translate>
 
<translate>
  
 +
<!--T:30-->
 
Every day you can update to the latest daily:
 
Every day you can update to the latest daily:
 
</translate>
 
</translate>
Line 140: Line 162:
 
<translate>
 
<translate>
  
 +
<!--T:31-->
 
{{Emphasis|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|compiling]].
 
{{Emphasis|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|compiling]].
  
 +
<!--T:32-->
 
Run the daily (PPA) version of FreeCAD:
 
Run the daily (PPA) version of FreeCAD:
 
</translate>
 
</translate>
Line 149: Line 173:
 
<translate>
 
<translate>
  
 +
<!--T:33-->
 
{{Emphasis|Note:}} it is possible to install both the {{incode|-stable}} and {{incode|-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 {{incode|freecad-daily}}, but for the stable version it is just {{incode|freecad}}.
 
{{Emphasis|Note:}} it is possible to install both the {{incode|-stable}} and {{incode|-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 {{incode|freecad-daily}}, but for the stable version it is just {{incode|freecad}}.
 
</translate>
 
</translate>
Line 154: Line 179:
 
</div> <!--END of UBUNTU collapsible div. Do not remove.-->
 
</div> <!--END of UBUNTU collapsible div. Do not remove.-->
 
<translate>
 
<translate>
==Debian and other Debian-based systems==
+
==Debian and other Debian-based systems== <!--T:34-->
  
 +
<!--T:35-->
 
Since Debian Lenny, FreeCAD is available directly from the Debian software repositories and can be installed via synaptic or simply with:
 
Since Debian Lenny, FreeCAD is available directly from the Debian software repositories and can be installed via synaptic or simply with:
  
Line 166: Line 192:
 
<div class="mw-collapsible mw-collapsed toccolours">
 
<div class="mw-collapsible mw-collapsed toccolours">
 
<translate>
 
<translate>
==OpenSUSE==
+
==OpenSUSE== <!--T:36-->
  
 +
<!--T:37-->
 
FreeCAD is typically installed with YAST (abbr. Yet another Setup Tool) the Linux operating system setup and configuration tool, or in any terminal/console (root rights required) with:
 
FreeCAD is typically installed with YAST (abbr. Yet another Setup Tool) the Linux operating system setup and configuration tool, or in any terminal/console (root rights required) with:
  
Line 176: Line 203:
 
<translate>
 
<translate>
  
 +
<!--T:38-->
 
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.  
 
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.  
 
</translate>
 
</translate>
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
<translate>
 
<translate>
=== Stable ===
+
=== Stable === <!--T:39-->
  
 +
<!--T:40-->
 
The stable package version: [https://software.opensuse.org/package/FreeCAD Stable repositories on openSUSE]. The correct openSUSE distribution version must be selected in the lower part of the web page.
 
The stable package version: [https://software.opensuse.org/package/FreeCAD Stable repositories on openSUSE]. The correct openSUSE distribution version must be selected in the lower part of the web page.
  
 +
<!--T:41-->
 
Note: openSUSE has several options to choose from when downloading FreeCAD. To view these options, visit [https://software.opensuse.org/search?utf8=%E2%9C%93&baseproject=ALL&q=FreeCAD Survey of stable repositories on openSUSE]. Generally for selecting the correct openSUSE distribution needed it is necessary to click on the particular {{KEY|View}} button.
 
Note: openSUSE has several options to choose from when downloading FreeCAD. To view these options, visit [https://software.opensuse.org/search?utf8=%E2%9C%93&baseproject=ALL&q=FreeCAD Survey of stable repositories on openSUSE]. Generally for selecting the correct openSUSE distribution needed it is necessary to click on the particular {{KEY|View}} button.
  
=== Development ===
+
=== Development === <!--T:42-->
  
 +
<!--T:43-->
 
Latest development releases AKA {{Emphasis|unstable}}: [https://software.opensuse.org/download.html?project=science%3Aunstable&package=FreeCAD Unstable repositories listings on openSUSE]
 
Latest development releases AKA {{Emphasis|unstable}}: [https://software.opensuse.org/download.html?project=science%3Aunstable&package=FreeCAD Unstable repositories listings on openSUSE]
  
 +
<!--T:44-->
 
It is recommended to grab the binary packages directly. Then select the correct distribution for your installed openSUSE OS.
 
It is recommended to grab the binary packages directly. Then select the correct distribution for your installed openSUSE OS.
 
</translate>
 
</translate>
Line 195: Line 227:
 
</div> <!-- END of OpenSUSE collapsible div section. Do not remove! -->
 
</div> <!-- END of OpenSUSE collapsible div section. Do not remove! -->
 
<translate>
 
<translate>
==Gentoo==
+
==Gentoo== <!--T:45-->
  
 +
<!--T:46-->
 
FreeCAD can be built/installed simply by issuing:
 
FreeCAD can be built/installed simply by issuing:
  
Line 207: Line 240:
 
<div class="mw-collapsible mw-collapsed toccolours">
 
<div class="mw-collapsible mw-collapsed toccolours">
 
<translate>
 
<translate>
==Fedora==
+
==Fedora== <!--T:47-->
  
 +
<!--T:48-->
 
FreeCAD has been included in the official Fedora packages since Fedora 20. It can be installed from the command line with:
 
FreeCAD has been included in the official Fedora packages since Fedora 20. It can be installed from the command line with:
  
Line 219: Line 253:
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
 
<translate>
 
<translate>
 +
<!--T:49-->
 
On older Fedora releases, that was:
 
On older Fedora releases, that was:
  
Line 227: Line 262:
 
<translate>
 
<translate>
  
 +
<!--T:50-->
 
The gui packages managers can also be used. Search for </translate>"freecad".<translate>
 
The gui packages managers can also be used. Search for </translate>"freecad".<translate>
  
 +
<!--T:51-->
 
The official release package version tends to be well behind the FreeCAD releases. [http://rpms.remirepo.net/rpmphp/zoom.php?rpm=freecad Package: freecad] shows the versions included in the Fedora repositories over time and versions.
 
The official release package version tends to be well behind the FreeCAD releases. [http://rpms.remirepo.net/rpmphp/zoom.php?rpm=freecad Package: freecad] shows the versions included in the Fedora repositories over time and versions.
  
 +
<!--T:52-->
 
More current versions can be obtained by downloading one of the </translate>[https://github.com/FreeCAD/FreeCAD/releases/ .AppImage]<translate>
 
More current versions can be obtained by downloading one of the </translate>[https://github.com/FreeCAD/FreeCAD/releases/ .AppImage]<translate>
 +
<!--T:53-->
 
releases from the github repository. These work fine on Fedora.
 
releases from the github repository. These work fine on Fedora.
  
 +
<!--T:54-->
 
If you want to keep up with the absolute latest daily builds, FreeCAD is also available on </translate>[https://copr.fedorainfracloud.org/groups/g/freecad/coprs/ copr]<translate>
 
If you want to keep up with the absolute latest daily builds, FreeCAD is also available on </translate>[https://copr.fedorainfracloud.org/groups/g/freecad/coprs/ copr]<translate>
 +
<!--T:55-->
 
. To install the build from there, in a terminal session, enter:
 
. To install the build from there, in a terminal session, enter:
  
Line 244: Line 285:
 
<translate>
 
<translate>
  
 +
<!--T:56-->
 
That leaves the </translate>copr<translate>  
 
That leaves the </translate>copr<translate>  
 +
<!--T:57-->
 
repository active, so
 
repository active, so
  
Line 253: Line 296:
 
<translate>
 
<translate>
  
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>  
+
<!--T:58-->
 +
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>  <!--T:59--> again after the initial install. The </translate>copr<translate>
 +
<!--T:60-->
 
repository only keeps builds from the past 2 weeks. This is not a solution if you want to pick a specific older version.
 
repository only keeps builds from the past 2 weeks. This is not a solution if you want to pick a specific older version.
  
 +
<!--T:61-->
 
Instructions are also available on [[Compile on Linux/Unix|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.
 
Instructions are also available on [[Compile on Linux/Unix|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.
 
</translate>
 
</translate>
Line 261: Line 307:
 
</div> <!-- END of Fedora collapsible div section. Do not remove! -->
 
</div> <!-- END of Fedora collapsible div section. Do not remove! -->
 
<translate>
 
<translate>
==Arch==  
+
==Arch== <!--T:62-->
  
  
 +
<!--T:63-->
 
Installing FreeCAD on Arch Linux and derivatives (ex. Manjaro):
 
Installing FreeCAD on Arch Linux and derivatives (ex. Manjaro):
  
Line 272: Line 319:
 
<translate>
 
<translate>
  
==Other==  
+
==Other== <!--T:64-->
  
 +
<!--T:65-->
 
If you find out that your system features FreeCAD but is not documented in this page, please tell us on the [http://forum.freecadweb.org/viewforum.php?f=21 forum]!
 
If you find out that your system features FreeCAD but is not documented in this page, please tell us on the [http://forum.freecadweb.org/viewforum.php?f=21 forum]!
  
 +
<!--T:66-->
 
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.
 
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===  
+
===Manual install on .deb based systems=== <!--T:67-->
  
 +
<!--T:68-->
 
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|Download]] page. <br />
 
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|Download]] page. <br />
 
{{DownloadUnixStable}}  
 
{{DownloadUnixStable}}  
  
 +
<!--T:69-->
 
Once you downloaded the .deb corresponding to your system version, if you have the [[wikipedia:Debian#GDEBI|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.
 
Once you downloaded the .deb corresponding to your system version, if you have the [[wikipedia:Debian#GDEBI|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:
 
Alternatively you can also install it from the terminal, navigating to where you downloaded the file, and type:
Line 292: Line 343:
 
<translate>
 
<translate>
  
 +
<!--T:70-->
 
changing Name_of_your_FreeCAD_package.deb by the name of the file you downloaded.
 
changing Name_of_your_FreeCAD_package.deb by the name of the file you downloaded.
  
 +
<!--T:71-->
 
After you installed FreeCAD, a startup icon will be added in the "Graphic" section of your Start Menu.
 
After you installed FreeCAD, a startup icon will be added in the "Graphic" section of your Start Menu.
  
===Installing on other Linux/Unix systems===  
+
===Installing on other Linux/Unix systems=== <!--T:72-->
  
 +
<!--T:73-->
 
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.
 
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.
  
Line 311: Line 365:
 
<translate>
 
<translate>
  
 +
<!--T:74-->
 
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>[https://github.com/FreeCAD/FreeCAD/releases/ .AppImage]<translate>  
 
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>[https://github.com/FreeCAD/FreeCAD/releases/ .AppImage]<translate>  
 +
<!--T:75-->
 
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.
 
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.
  
 +
<!--T:76-->
 
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 on Linux/Unix|compile FreeCAD yourself]].
 
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 on Linux/Unix|compile FreeCAD yourself]].
  
===Installing Windows Version on Linux===  
+
===Installing Windows Version on Linux=== <!--T:77-->
  
 +
<!--T:78-->
 
See the [[Install on Windows|Install on Windows]] page.
 
See the [[Install on Windows|Install on Windows]] page.
  
== Next Step ==  
+
== Next Step == <!--T:79-->
  
 +
<!--T:80-->
 
Once you've got FreeCAD installed, it's time to [[Getting started|get started]]!
 
Once you've got FreeCAD installed, it's time to [[Getting started|get started]]!
  
 +
<!--T:81-->
 
{{Docnav
 
{{Docnav
 
|[[Install on Windows|Install on Windows]]
 
|[[Install on Windows|Install on Windows]]

Revision as of 13:26, 4 June 2020

Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Türkçe • ‎español • ‎français • ‎hrvatski • ‎italiano • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎svenska • ‎čeština • ‎български • ‎русский • ‎українська • ‎中文 • ‎中文(中国大陆)‎ • ‎日本語

Overview


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 some:

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

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

Personal Package Archive (PPA) for the stable FreeCAD release is maintained by the FreeCAD community on on Launchpad. The Launchpad repository is called freecad-stable .

GUI

Install the stable PPA via the Graphical User Interface (GUI):

1. Navigate to Ubuntu Software → Software & Updates → Software Sources → Other Software
2. Click on And, then copy and paste the following line
ppa:freecad-maintainers/freecad-stable
3. 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.

CLI

Install the stable PPA via the Command Line Interface (CLI):

1. Add the PPA to your software sources:
sudo add-apt-repository ppa:freecad-maintainers/freecad-stable
2. Retrieve the updated package lists:
sudo apt update
3. 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.

Checking Installation

4. Once you have the stable PPA added to your sources using one of the above methods, the freecad package will install this PPA version over the one provided by the Ubuntu Universe repository. You can see the available versions with the following apt-cache command:
apt-cache policy freecad
The output should look similar to the following (of course the version info will vary):
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 http://ppa.launchpad.net/freecad-maintainers/freecad-stable/ubuntu bionic/main amd64 Packages
     0.16.6712+dfsg1-1ubuntu2 500
        500 http://archive.ubuntu.com/ubuntu bionic/universe amd64 Packages
ubuntu@ubuntu:~$ apt-cache policy freecad-doc
5. Invoke the stable (PPA) version of FreeCAD from the GUI or CLI. The latter method is as follows:
./freecad

Development PPA (Daily)

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 also hosted on Launchpad and is called freecad-daily.

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:

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

Every day you can update to the latest daily:

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:

freecad-daily

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

OpenSUSE

FreeCAD is typically installed with YAST (abbr. Yet another Setup Tool) the Linux operating system setup and configuration tool, or in any terminal/console (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.

Stable

The stable package version: Stable repositories on openSUSE. The correct openSUSE distribution version must be selected in the lower part of the web page.

Note: openSUSE has several options to choose from when downloading FreeCAD. To view these options, visit Survey of stable repositories on openSUSE. Generally for selecting the correct openSUSE distribution needed it is necessary to click on the particular View button.

Development

Latest development releases AKA unstable: Unstable repositories listings on openSUSE

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

Gentoo

FreeCAD can be built/installed simply by issuing:

emerge freecad

Fedora

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 "freecad". 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 .AppImagereleases 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 copr. To install the build from there, in a terminal session, enter:

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

That leaves the copr 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 @freecad/nightly again after the initial install. The copr 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.

Arch

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

pacman -S freecad

Other

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 .AppImage 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.

Next Step

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