Scroll to navigation

FREECAD(1) Linux User's Manual FREECAD(1)


freecad - Extensible Open Source CAx program


freecad [options] files
freecadcmd [options] files


FreeCAD is an Open Source CAx RAD based on OpenCasCade, Qt and Python. It features some key concepts like macro recording, workbenches, ability to run as a server and dynamically loadable application extensions and it is designed to be platform independent.


freecad starts with a GUI while freecadcmd is only a pure command line version that starts a Python interpreter.


These programs follow the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of the options supported by freecad is included below.

Generic options

-c, --console
Starts in console mode.
Dumps configuration.
--get-config arg
Prints the value of the requested configuration key.
-h, --help
Prints help message.
--response-file arg
Can be specified with '@name', too.
-v, --version
Prints version string.


-l, --write-log
Writes a log file to $HOME/.FreeCAD/FreeCAD.log
--log-file arg
Unlike --write-log this allows logging to an arbitrary file.
-M, --module-path arg
Additional module paths.
-P, --python-path arg
Additional Python paths.
-s, --system-cfg arg
System config file to load/save system settings.
Allow to run a single instance of the application.
-t, --run-test arg
Test case - or 0 for all.
-u, --user-cfg arg
User config file to load/save user settings.


To get more information about FreeCAD, please visit


To report a bug, please visit


This manual page was written by Werner Mayer and Salman Mohammadi <>.
March 22, 2019 freecad