Download: Difference between revisions

From FreeCAD Documentation
(try to emphasize development options)
(Added win portable version)
 
(228 intermediate revisions by 35 users not shown)
Line 1: Line 1:
<languages/>
There are several '''downloads''' for various operating systems available. Before downloading keep in mind:
{{TOCright}}
{{VeryImportantMessage|'''FreeCAD is still in ALPHA state and not ready for production use'''}}
<translate>


== Current stable version == <!--T:2-->
== Stable FreeCAD installers ==


<!--T:3-->
The FreeCAD team provides ready-to-install packages for [[Image:windows.png|16px]] '''Windows''' (XP, Vista and 7, 32 and 64bits), [[Image:mac.png|16px]] '''Mac OS X''' (Snow Leopard 10.6), and [[Image:linux.png|16px]] '''Debian-based Linux systems''' (Debian, Ubuntu, 32 and 64bits). Below are links to the Stable installation files for the various systems. Also available on the [http://sourceforge.net/projects/free-cad/files/ FreeCAD Files page] are '''unstable''' packages, that provide the bleeding-edge new features being worked on, but might crash more often or contain features that are incompatible with earlier versions.
The 0.21.2 release of FreeCAD was published on 2023-11-14. To find out what's new, see the [[Release_notes_0.21|release notes]].
{|
|{{DownloadWindowsStable}} || || {{DownloadUnixStable}} || || {{DownloadMacStable}}
|}


<!--T:53-->
=== Development Versions ===
You can find SHA256 checksums to verify the integrity of your download on the [https://github.com/FreeCAD/FreeCAD/releases/tag/0.21.2 0.21.2 release page].
If you want to install FreeCAD with more in-development features, and are willing to accept that these versions have a higher chance of bugs and crashes, then you can check the official [http://sourceforge.net/projects/free-cad/files/ FreeCAD Files page] to download 64 bit, older, or unstable releases. Of course, if you want to stay even more on the bleeding edge of development, you can [[compiling| compile]] FreeCAD, or use the [[#Ubuntu PPA packages|Ubuntu daily build updates]].


<!--T:57-->
===Notes for Windows users===
Previous versions can be downloaded from the [https://github.com/FreeCAD/FreeCAD/releases releases] page.


</translate><!--Do not remove this tag. It would add even more places where version info has to be kept up to date-->
The windows installer should also work on older Windows platforms, but has not always been tested. You need ''Windows Installer V1'' on your system (msiexec.exe). See [[Install on Windows|Installing on Windows]] for details about different installation options. Download the latest .msi file for windows systems, or the appropriate .deb file for your version of Ubuntu or Debian.
{| cellpadding="20" style="font-size:120%"


| align=center | [[Image:Windows.png]]
===Notes for Linux users===


[[Installing_on_Windows|Install instructions]]
On most recent distributions such as Debian, Ubuntu or Arch, FreeCAD is included in the official distribution's packages repository, and you are advised to preferably get FreeCAD from there, to make sure you have a version that is 100% compatible with your system. The pivy python module (usually named python-pivy) is needed by FreeCAD from version 0.9 or above. If it is not available on your system, you must download it from here too.


[https://github.com/FreeCAD/FreeCAD/releases/download/0.21.2/FreeCAD-0.21.2-WIN-x64-installer-1.exe 64-bit installer]
===Notes for Mac users===


[https://github.com/FreeCAD/FreeCAD/releases/download/0.21.2/FreeCAD-0.21.2-Windows-x86_64.7z 64-bit portable version (.7z)]
We rely on very few people to help building Mac OSX packages, so it doesn't get updated as often as the other platforms. The version available on this site might be slightly outdated.
(To compile the most up-to-date version from source see [[CompileOnMac]])


| align=center | [[Image:Mac.png]]
== Ubuntu PPA packages ==


[[Installing_on_Mac|Install instructions]]
The [https://launchpad.net/~freecad-maintainers FreeCAD Launchpad team] has set up two PPA (Personal Package Archive) repositories that allow easy install of Ubuntu packages based on the development branch. Updates to the software are pushed to the Ubuntu Update Manager, which makes it the easiest way to get the latest FreeCAD build.


[https://github.com/FreeCAD/FreeCAD/releases/download/0.21.2/FreeCAD-0.21.2-macOS-arm64.dmg ARM (M1/M2) disk image]
* [https://launchpad.net/~freecad-maintainers/+archive/freecad-daily FreeCAD Daily Builds]: an automatic daily build system, which can provide you with a fresh, daily-up-to-date version of FreeCAD. Please be advised that the packages from this bleeding edge PPA may be broken from time to time.
* [https://launchpad.net/~freecad-maintainers/+archive/freecad-dev FreeCAD Devel]: packages available through this PPA are actually copied from the Daily Builds PPA but are summarily tested beforehand. Update schedule is slower, and varies from 1-3 weeks.


[https://github.com/FreeCAD/FreeCAD/releases/download/0.21.2/FreeCAD-0.21.2-macOS-intel-x86_64.dmg Intel disk image]
Current supported architectures and versions are:


| align=center | [[Image:Linux_with_text.png]]
* Ubuntu 10.04 LTS (Lucid Lynx) 32 & 64-Bit
* Ubuntu 10.10 (Maverick Meerkat) 32 & 64-Bit
* Ubuntu 11.04 (Natty Narwhal) 32 & 64-Bit


[[Installing_on_Linux|Install instructions]]
==== Adding the PPA and installing FreeCAD from the console ====


[https://github.com/FreeCAD/FreeCAD/releases/download/0.21.2/FreeCAD-0.21.2-Linux-x86_64.AppImage x86_64 AppImage]
Type (or copy-paste) these commands in a console to add the PPA and install FreeCAD along with the documentation:


[https://github.com/FreeCAD/FreeCAD/releases/download/0.21.2/FreeCAD-0.21.2-Linux-aarch64.AppImage aarch64 AppImage]
For FreeCAD Daily Builds:
sudo add-apt-repository ppa:freecad-maintainers/freecad-daily
For FreeCAD Devel:
sudo add-apt-repository ppa:freecad-maintainers/freecad-dev
Then:
sudo apt-get update
sudo apt-get upgrade
sudo apt-get install freecad freecad-doc


|}
==== Adding the PPA and installing FreeCAD from the GUI ====
<translate>

Add to your system's Software Sources one of the following PPA (read [http://askubuntu.com/questions/4983/what-are-ppas-and-how-do-i-use-them/5102#5102%29 What are PPAs and how do I use them?] if you don't know how):

* For FreeCAD Daily Builds: '''ppa:freecad-maintainers/freecad-daily'''
* For FreeCAD Devel: '''ppa:freecad-maintainers/freecad-dev'''

When a dialog window asks you to refresh your software sources, click OK.

Now you can install FreeCAD and FreeCAD documentation through the Ubuntu Software Center, or your package manager of choice.

== Alternative FreeCAD builds ==

These are versions of FreeCAD built by other persons and not officially maintained by the FreeCAD team. They may include customized parts or be optimized for certain types of processors, or other modifications that the package maintainers judged necessary. But they are also sometimes better suited for certain operating systems. Note that on most common linux distributions, official packages are typically installed by the system's package management tool, so you don't need to download and install FreeCAD manually.

*[http://packages.debian.org/freecad Official Debian package]
*[http://packages.ubuntu.com/freecad Official Ubuntu package]
*[http://software.opensuse.org/search?q=freecad&baseproject=openSUSE%3A11.4&lang=en&exclude_debug=true Official OpenSuse package]
*[http://www.softpedia.com/get/Multimedia/Graphic/Graphic-Editors/FreeCAD.shtml Softpedia Windows build]
*[http://packman.links2linux.de/package/FreeCAD Packman RPM package (for opensuse, fedora)]
*[http://slackbuilds.org/repository/13.37/graphics/FreeCAD/ Slackbuilds package (for Slackware)]
*[http://aur.archlinux.org/packages.php?K=freecad ArchLinux AUR package]
*[http://packages.gentoo.org/package/media-gfx/freecad Gentoo ebuild package]
*[https://svn.pardus.org.tr/pardus/playground/kaan.aksit/2011/freecad/actions.py Pardus linux build script]

== FreeCAD documentation ==

The user documentation of FreeCAD is being written together by the developers and the users community, on this wiki site. The best way is to read it online, so you are sure to get the latest version:

* [[Online Help Toc|The FreeCAD Manual]]

The manual can also be displayed as one big text, so you can print it or save it as a pdf file:

* [[Manual|All-in-one printable version]]

The manual is also be compiled as a qt help file, so it can be browsed offline with the Qt help viewer. This is usually made at each release and is available together with FreeCAD package on most linux software repositories (on debian/ubuntu-based systems, look for '''freecad-doc''' package) and is also bundled in the windows installer. To access it, simply open the "help" menu inside FreeCAD, or use the "What's this?" button.

For convenience, we also provide a pdf version of this manual:

* [http://yorik.uncreated.net/archive/freecad010.pdf 0.10 Manual (Pdf file)]
* [http://yorik.uncreated.net/scripts/freecad011.pdf 0.11 Manual (Pdf file)]

Here you can also find a copy of the OpenCasCade 5.2 docs, in a .chm file. After 5.2, the openCasCade documentation is not available as a single file anymore, but as a heavy 180Mb package. So, since there is little change, we keep this one around for convenience:

*[http://www.4shared.com/file/128871432/96b15e62/occ52.html OpenCasCADE 5.2 documentation]


=== Notes for Windows users === <!--T:58-->
== FreeCAD Source package ==


<!--T:5-->
For all other platforms you need to compile FreeCAD on your own from the Source package. You might also want to compile FreeCAD yourself if you want to optimize certain things, or customize certain parts of FreeCAD. Instructions for compiling can be found on the [[CompileOnWindows]], [[CompileOnMac]] and [[CompileOnUnix]] pages. You can grab a zip or tar.gz file containing the latest official version here (look for the latest version for your system):
* The following Windows versions are supported: 64-bit 7/8/10/11. 32-bit Windows is not supported.
* The package can also be installed from the [https://chocolatey.org/packages/freecad Chocolatey] manager. The Chocolatey package is currently not up-to-date.


=== Notes for macOS users === <!--T:59-->
*[http://sourceforge.net/projects/free-cad/files/ official FreeCAD Files repository]


<!--T:9-->
Alternatively, you can also download latest source code from the SVN repository. You'll get a more recent version, but it might contain bugs or even fail to compile. Instructions for accessing the SVN repository can be found here:
* MacOS 10.12 Sierra is the minimum supported version.
* For macOS 12 and older the "Unsigned Intel disk image" should be used, the signed version does not work on those systems.


=== Notes for GNU/Linux users === <!--T:6-->
*[http://sourceforge.net/svn/?group_id=49159 FreeCAD SVN repository]


<!--T:51-->
You can also download automatically a GNU tarball from the latest source code tree or any part of it by using the code browser and clicking the "Download GNU tarball" at any time. The trunk folder contains the current development version, while the branches folder contains a snapshot of all stable releases to date.
Most distributions carry FreeCAD in their official repositories, however, if the distribution doesn't follow a rolling release model the version they provide might be outdated. Instead you can download the AppImage above, mark it as executable and launch it without installation.


<!--T:54-->
*[http://free-cad.svn.sourceforge.net/viewvc/free-cad/ FreeCAD SVN browser]
Please see the [[Installing_on_Linux|Installing on Linux]] page for more installation options, including daily packages for Ubuntu and derivatives.


<!--T:55-->
== FreeCAD LibPack ==
A portable version that doesn't need installation can be achieved by starting FreeCAD with these commands:


</translate>
To collect all the needed libraries to compile FreeCAD can be a time consuming task. So we deliver a convenient package for development on Windows (VS8) with all needed libraries. You can download the latest version of the libpack from
{{Code|lang=text|code=
cd path/to/directory_containing_AppImage/
chmod +x ./name_of_AppImage_file.AppImage
HOME="$PWD/Settings" FREECAD_USER_HOME="$PWD/Settings" ./name_of_AppImage_file.AppImage
}}
<translate>


<!--T:56-->
*[http://sourceforge.net/project/showfiles.php?group_id=49159&package_id=157551 FreeCAD LibPack]
More information about FreeCAD's environment variables can be found on [[Start_up_and_Configuration#Environment_variables|the configuration page]].


== Development versions == <!--T:60-->
For linux, you will normally find all necessary libraries in your software management system, so you should just read the [[CompileOnUnix]] page.


<!--T:4-->
== Additional modules ==
FreeCAD's development is active.
* For development builds and development source code, see the [https://github.com/FreeCAD/FreeCAD-Bundle/releases/tag/weekly-builds weekly builds] page.
* To compile the latest source code, see [[Compiling|compiling]].


== Additional modules and macros == <!--T:44-->
There are additional modules, addons of plugins for FreeCAD developed outside of the main FreeCAD development team. They are listed here but are not officially supported by the FreeCAD team.


<!--T:52-->
*[http://ja.orgfree.com/freecad.htm Fold module]: a module in development for working with metal sheets.
The FreeCAD community provides many additional modules and macros. Since 0.17 they can be easily installed from within FreeCAD using the [[Image:Std_AddonMgr.svg|24px]] [[Std_AddonMgr|Addon manager]].
*[http://gitorious.org/freecad-ship Ship module]: a module in development for ship design.


{{Languages| {{de|Download/de}} {{es|Download/es}} {{fr|Download/fr}} {{ru|Download/ru}} {{se|Download/se}} }}


</translate>
[[Category:User Documentation]]
{{Userdocnavi{{#translation:}}}}

Latest revision as of 16:07, 13 January 2024

Current stable version

The 0.21.2 release of FreeCAD was published on 2023-11-14. To find out what's new, see the release notes.

You can find SHA256 checksums to verify the integrity of your download on the 0.21.2 release page.

Previous versions can be downloaded from the releases page.

Install instructions

64-bit installer

64-bit portable version (.7z)

Install instructions

ARM (M1/M2) disk image

Intel disk image

Install instructions

x86_64 AppImage

aarch64 AppImage

Notes for Windows users

  • The following Windows versions are supported: 64-bit 7/8/10/11. 32-bit Windows is not supported.
  • The package can also be installed from the Chocolatey manager. The Chocolatey package is currently not up-to-date.

Notes for macOS users

  • MacOS 10.12 Sierra is the minimum supported version.
  • For macOS 12 and older the "Unsigned Intel disk image" should be used, the signed version does not work on those systems.

Notes for GNU/Linux users

Most distributions carry FreeCAD in their official repositories, however, if the distribution doesn't follow a rolling release model the version they provide might be outdated. Instead you can download the AppImage above, mark it as executable and launch it without installation.

Please see the Installing on Linux page for more installation options, including daily packages for Ubuntu and derivatives.

A portable version that doesn't need installation can be achieved by starting FreeCAD with these commands:

cd path/to/directory_containing_AppImage/
chmod +x ./name_of_AppImage_file.AppImage
HOME="$PWD/Settings" FREECAD_USER_HOME="$PWD/Settings" ./name_of_AppImage_file.AppImage

More information about FreeCAD's environment variables can be found on the configuration page.

Development versions

FreeCAD's development is active.

  • For development builds and development source code, see the weekly builds page.
  • To compile the latest source code, see compiling.

Additional modules and macros

The FreeCAD community provides many additional modules and macros. Since 0.17 they can be easily installed from within FreeCAD using the Addon manager.