Download: Difference between revisions

From FreeCAD Documentation
(Update: daily build packages are now called 'freecad-daily')
m (alternate wording)
(44 intermediate revisions by 12 users not shown)
Line 1: Line 1:
__NOTOC__
<languages/>

<div id="itsfree" style="text-align:left;color:black;background:#f6f6f6;margin:1em 7em;padding:0.5em 2em;border:2px solid #a7d7f9;">
<translate>
<translate>
<!--T:1-->
<!--T:1-->
Please note that FreeCAD has still not reached a version 1.0 status in our view, and might not be ready for production use. Nevertheless multitudes of users use it. To find out if FreeCAD is appropriate for your project, please check out the [https://forum.freecadweb.org FreeCAD forum].
There are several '''downloads''' for various operating systems available. Before downloading keep in mind:
</translate></div><translate>
{{VeryImportantMessage|'''FreeCAD is under heavy development and might not be ready for production use'''}}


==Official Installers== <!--T:2-->
== Current Stable Version == <!--T:2-->


=== Stable FreeCAD installers === <!--T:3-->
<!--T:3-->
The first 0.17 release of FreeCAD (0.17.13509) was published on 2018-04-06. Many bug fix releases have been published since then, the latest bug fix release '''0.17.13541''' was published on 2018-08-16. It might not be available to all operating systems at this time. To find out what's new, see the [[Release notes 0.17|release notes]].
The FreeCAD team provides ready-to-install packages for [[Image:windows.png|16px]] '''Windows''' (32 and 64bits), [[Image:mac.png|16px]] '''Mac OS X''' (Lion 10.7 32 and 64bits), and [[Image:linux.png|16px]] '''Ubuntu''' (LTS and current, 32 and 64bits). Below are links to the Stable installation files for the various systems. Also available on the [https://github.com/FreeCAD/FreeCAD/releases 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.
{| align="center" cellpadding="20"
|{{DownloadWindowsStable}} || || {{DownloadUnixStable}} || || {{DownloadMacStable}}
|}


=== Development Versions === <!--T:4-->
<!--T:53-->
You will find SHA256 checksums (to verify integrity of your download) and Windows portable versions on the [https://github.com/FreeCAD/FreeCAD/releases/tag/0.17 0.17 Release page on GitHub]. (Older portable builds have been pruned. Availability will return in the future)
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 [https://github.com/FreeCAD/FreeCAD/releases 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]] or install one of the pre-release files from the github page above.


===Notes for Windows users=== <!--T:5-->
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.

===Notes for Linux users=== <!--T:6-->
On most recent distributions such as Debian, Ubuntu, Fedora 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.

====Notes for Debian users==== <!--T:7-->
Because of a licensing conflict between third-party libraries required by FreeCAD, the freecad package was removed from the current Debian stable (wheezy) repository. This will be solved when the next stable release of FreeCAD comes out. In the meanwhile, you can either [[CompileOnUnix|compile FreeCAD]] or use an [[#Alternative_FreeCAD_builds|alternate build]].

<!--T:8-->
You should also note that although Ubuntu is based on Debian, the Ubuntu PPA packages are NOT compatible with Debian.

===Notes for Mac users=== <!--T:9-->
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]])

<!--T:41-->
You can follow the topic dedicate to Mac on the [http://forum.freecadweb.org/viewtopic.php?f=4&t=5452 forum]

== Ubuntu PPA Packages == <!--T:10-->
The [https://launchpad.net/~freecad-maintainers FreeCAD Launchpad team] has set up a PPA (Personal Package Archive) repository that allows 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.

<!--T:11-->
The [https://launchpad.net/~freecad-maintainers/+archive/freecad-daily FreeCAD Daily Builds] PPA is an automatic daily build system, which can provide you with a fresh, daily-up-to-date version of FreeCAD. Please be advised that although the packages from this bleeding edge PPA may be broken from time to time, they will likely contain numerous bug fixes and feature updates.

<!--T:12-->
Current supported architectures and versions are:
* Ubuntu 14.04 (Trusty Tahr) 32 & 64-Bit
* Ubuntu 15.10 (Wily) 32 & 64-Bit
* Ubuntu 16.04 (Xenial) 32 & 64-Bit
* Ubuntu 16.10 (Yakkety) 32 & 64-Bit

==== Adding the PPA and installing FreeCAD from the console ==== <!--T:13-->
Type (or copy-paste) these commands in a console to add the PPA and install FreeCAD along with the documentation:
</translate>
</translate>
{| align="center" cellpadding="20" style="font-size:120%"
{{Code|code=
|[[Image:Windows.png]] [https://github.com/FreeCAD/FreeCAD/releases/download/0.17/FreeCAD-0.17.13528.5c3f7bf-WIN-x86-installer.exe Windows] <small>32 bits</small><br/>[[Image:Windows.png]] [https://github.com/FreeCAD/FreeCAD/releases/download/0.17/FreeCAD-0.17.13541.9948ee4-WIN-x64-installer.exe Windows] <small>64 bits</small> || || [[Image:Mac.png]] [https://github.com/FreeCAD/FreeCAD/releases/download/0.17/FreeCAD_0.17-13541.9948ee4-OSX-x86_64-Qt5.dmg Mac] <small>64-bit</small> || || [[Image:AppImage-logo.png]] [https://github.com/FreeCAD/FreeCAD/releases/download/0.17/FreeCAD-0.17.13541.9948ee4.glibc2.17-x86_64.AppImage AppImage (Linux)] <small>64bit</small>
sudo add-apt-repository ppa:freecad-maintainers/freecad-daily
}}
|}
<translate>
<translate>
<!--T:14-->
Then:
</translate>
{{Code|code=
sudo apt-get update
sudo apt-get upgrade
sudo apt-get install freecad-daily freecad-daily-doc
}}
<translate>
==== Adding the PPA and installing FreeCAD from the GUI ==== <!--T:15-->
Add to your system's Software Sources 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):
</translate>
{{Code|code=
ppa:freecad-maintainers/freecad-daily
}}
<translate>
<!--T:16-->
When a dialog window asks you to refresh your software sources, click OK.


==== Notes for Windows users ==== <!--T:5-->
<!--T:17-->
Now you can install FreeCAD and FreeCAD documentation through the Ubuntu Software Center, or your package manager of choice.
* The 32-Bit installer (x86) supports the following versions of Windows: 7/8/10.
* The 64-Bit installer (x64) supports the following versions of Windows: 7/8/10.


== Fedora package == <!--T:24-->
==== Notes for Mac OS X users ==== <!--T:9-->
To install FreeCAD on Fedora, make sure you have the *NONFREE* repositories installed (necessary because of OCC/OCE license)
Mac OS X 10.11 ''El Capitan'' is the minimum supported version.
</translate>
{{Code|code=
yum install freecad
}}
<translate>
<!--T:25-->
Or use the GUI installer.


== Alternative FreeCAD builds == <!--T:26-->
==== Notes for GNU/Linux users ==== <!--T:6-->
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. They might also be out-of-date, since the people who make those package may take time to grab the newer versions of FreeCAD. 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.


<!--T:27-->
<!--T:51-->
FreeCAD can be installed from most Linux distributions official repositories, but the version they provide might be quite dated and be missing many features. Instead you can download the linked AppImage above, mark it as executable and launch it without installation. Please see the [[Install on Unix]] page for more installation options, including how to get up-to-date packages for Ubuntu and derivatives .
*[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]
*[http://www.zultron.com/rpm-repo/ Unofficial but well maintained Fedora FreeCAD repository]
*[http://forum.freecadweb.org/viewtopic.php?f=4&t=2995 Unofficial Debian Wheezy package (32-Bit and 64-Bit)]


== FreeCAD documentation == <!--T:28-->
=== Development Versions === <!--T:4-->
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:
FreeCAD's development is always active! Do you want to check out the 0.18 development release? Get it on the [https://github.com/FreeCAD/FreeCAD/releases FreeCAD releases] page.
* [[Online Help Toc|The FreeCAD Manual]]


=== Additional Modules and Macros === <!--T:44-->
<!--T:29-->
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]]


<!--T:30-->
<!--T:52-->
The FreeCAD community provides a wealth of additional modules and macros. They can now easily be installed directly from within FreeCAD using the [[AddonManager|Addon manager]].
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.


<!--T:31-->
<!--T:40-->
[[Category:User Documentation]]
For convenience, with each release we also provide a pdf version of this manual:
* https://github.com/FreeCAD/FreeCAD/releases




<!--T:43-->
In this [http://sourceforge.net/projects/free-cad/files/FreeCAD%20Documentation/ Documentation-Directory on Sourceforge] you will also find Quick Reference Cards as PDF.
They list the pre-defined keyboard-shortcuts for the different workbenches.

<!--T:32-->
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]

== FreeCAD Source package == <!--T:33-->
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):
*[https://github.com/FreeCAD/FreeCAD/releases official FreeCAD Files repository]

<!--T:34-->
Alternatively, you can also download latest source code from the Git repositories. You'll get a more recent version, but it might contain bugs or even fail to compile. Instructions for accessing the Git repositories can be found here:
*[https://github.com/FreeCAD/FreeCAD FreeCAD Git repository on github]

<!--T:35-->
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.

== FreeCAD LibPack == <!--T:36-->
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 (VC8, VC11, and VC12) with all needed libraries. You can download the latest version of the libpack from:
*[https://github.com/FreeCAD/FreeCAD/releases FreeCAD LibPack]Download the version that matches your architecture and Visual C++ version.

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

== Additional macros, modules and related projects == <!--T:38-->
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.

=== Additional macros and other things === <!--T:39-->
*[[Macros recipes]]: additional tools for your FreeCAD installation.
*[http://github.com/maxbots/MendelMax MendelMax]: a macro suite for FreeCAD to generate a MendelMax machine.
*[[Drawing templates]]: additional SVG templates for the Drawing module.
*[http://github.com/yorikvanhavre/tumbler-fcstd-thumbnailer Tumbler thumbnailer]: show .FcStd files as thumbnails in Thunar and Marlin file managers.
*[http://github.com/yorikvanhavre/kde-fcstd-thumbnailer KDE thumbnailer]: show .FcStd files as thumbnails in KDE Dolphin file manager.
*[http://github.com/cblt2l/FreeCAD-CuraEngine-Plugin Cura Engine Plugin]: A plugin to use the CuraEngine gcode slicer from within FreeCAD.
*[http://github.com/quick61/FreeCAD_VidKit FreeCAD Vidkit]: The video clips and images are intended for use in the production of FreeCAD Tutorial and Demo videos.
*[http://github.com/yorikvanhavre/Draft-dxf-importer Draft DXF Im-Exporter]: Files needed to add DXF support (import-export) to FreeCAD

=== Additional modules === <!--T:44-->
*[http://forum.freecadweb.org/viewtopic.php?f=10&t=3391 Fold module]: a module for working with metal sheets (abandoned for some time, may not work anymore).
*[http://gitorious.org/freecad-ship Ship module], [http://jlcercos.wordpress.com/freecad-ship-en/ The blog of Jose Luis Cercós Pita] : a module in development for ship design (since 0.13, it included in official FreeCAD sources).
*[http://www.bolts-library.org/en/index.html BOLTS]: Open Library for standard parts (screws, nuts, washers ...)
*[http://github.com/hamish2014/FreeCAD_assembly2 Hamish's Assembly Workbench]: Assembly Workbench. Needs FreeCAD 0.15 to run.
*[http://github.com/hamish2014/FreeCAD_drawing_dimensioning Drawing Dimension Workbench]: Workbench to add dimensions to drawings. Needs FreeCAD 0.15 to run.
*[http://github.com/microelly2/Animation Animation Workbench]: Animate your FreeCAD-Models.
* [https://github.com/microelly2/freecad-pluginloader Plugin Loader]: Installer of additional packages. Now it works on Linux. Further information in the [http://forum.freecadweb.org/viewtopic.php?f=8&t=10556&hilit=plugin+loader forum] and the page [[Plugin_Loader|Plugin Loader]].
*[http://sourceforge.net/projects/eaglepcb2freecad/?source=navbar Eagle PCB 2 FreeCAD]: Import your PCB boards to FreeCAD .
*[https://github.com/looooo/FCGear FCGear]: Additional Workbench to create different types of gears, involute gear, involute rack, cycloide gear, bevel gear. Created by looooo. More information: [[Macro_FCGear|Macro FCGear]]
*[http://theseger.com/projects/2015/06/sheet-metal-addon-for-freecad/ Sheet Metal Workbench]: workbench for sheet metal bend and unfold supported
*[http://theseger.com/projects/2015/06/fasteners-workbench-for-freecad/ Fasteners Workbench]: workbench for fasteners based on the screw-makers macro
*[https://github.com/jptned/3DGuitar/ 3D Guitar]: Workbench to design a guitar. [http://forum.freecadweb.org/viewtopic.php?f=22&t=13394 Discussion here].
*[https://github.com/DeepSOIC/Lattice Lattice workbench]: FreeCAD workbench with advanced array tools

=== Related projects === <!--T:45-->
*[http://github.com/yorikvanhavre/FreeCAD-library FreeCAD Library]: This repository contains a library of Parts to be used in FreeCAD.
*[https://github.com/FreeCAD/FreeCAD-symbols FreeCAD 2D symbols]: 2D drawing symbols you can add to your drawings made with the drawing workbench.
*[http://www.openplm.org/ OpenPLM]: an online PLM platform with FreeCAD support.
*[http://rattlecad.sourceforge.net/ RattleCAD]: design bikes with freecad

<!--T:46-->
<br />
<br />

<!--T:40-->
[[Category:User Documentation]]
</translate>
</translate>
{{clear}}
<languages/>

Revision as of 22:24, 21 September 2018

Please note that FreeCAD has still not reached a version 1.0 status in our view, and might not be ready for production use. Nevertheless multitudes of users use it. To find out if FreeCAD is appropriate for your project, please check out the FreeCAD forum.

Current Stable Version

The first 0.17 release of FreeCAD (0.17.13509) was published on 2018-04-06. Many bug fix releases have been published since then, the latest bug fix release 0.17.13541 was published on 2018-08-16. It might not be available to all operating systems at this time. To find out what's new, see the release notes.

You will find SHA256 checksums (to verify integrity of your download) and Windows portable versions on the 0.17 Release page on GitHub. (Older portable builds have been pruned. Availability will return in the future)

Windows 32 bits
Windows 64 bits
Mac 64-bit AppImage (Linux) 64bit

Notes for Windows users

  • The 32-Bit installer (x86) supports the following versions of Windows: 7/8/10.
  • The 64-Bit installer (x64) supports the following versions of Windows: 7/8/10.

Notes for Mac OS X users

Mac OS X 10.11 El Capitan is the minimum supported version.

Notes for GNU/Linux users

FreeCAD can be installed from most Linux distributions official repositories, but the version they provide might be quite dated and be missing many features. Instead you can download the linked AppImage above, mark it as executable and launch it without installation. Please see the Install on Unix page for more installation options, including how to get up-to-date packages for Ubuntu and derivatives .

Development Versions

FreeCAD's development is always active! Do you want to check out the 0.18 development release? Get it on the FreeCAD releases page.

Additional Modules and Macros

The FreeCAD community provides a wealth of additional modules and macros. They can now easily be installed directly from within FreeCAD using the Addon manager.