FreeCAD Docker CLI mode: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
Line 78: Line 78:
{{Code|lang=bash|code=
{{Code|lang=bash|code=
$ docker run -it amrit3701/freecad-cli:lastest bash
$ docker run -it amrit3701/freecad-cli:lastest bash
root@f0ec904cf9b9:/# python3.7
root@f0ec904cf9b9:/# python3.8
Python 3.7.7 (default, Mar 10 2020, 17:25:08)
Python 3.8.5 (default, Jul 20 2020, 19:48:14)
[GCC 5.4.0 20160609] on linux
[GCC 7.5.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
Type "help", "copyright", "credits" or "license" for more information.
>>> import FreeCAD
>>> import FreeCAD
Line 88: Line 88:
}}
}}
<translate>
<translate>

===Launch FreeCADCmd=== <!--T:326-->
===Launch FreeCADCmd=== <!--T:326-->



Revision as of 17:36, 20 August 2020

This documentation is not finished. Please help and contribute documentation.

GuiCommand model explains how commands should be documented. Browse Category:UnfinishedDocu to see more incomplete pages like this one. See Category:Command Reference for all commands.

See WikiPages to learn about editing the wiki pages, and go to Help FreeCAD to learn about other ways in which you can contribute.

Overview

Docker image of FreeCAD compiled without GUI. This docker image is especially for developers who only want to use FreeCAD in the command-line interface (CLI).

Benefits

All of FreeCAD's dependencies are already installed, compatible with each other, and configured appropriately, allowing you to get started developing very quickly.

  • Easy to use and lightweight.
  • It gives better performance in terms of speed.
  • No need to add FreeCAD paths to import it into Python.

Docker Repository

Prerequisites

  • 3 GB of free storage
  • Docker

Installation

  1. Pull the Docker image.
    docker pull amrit3701/freecad-cli:latest
    
  2. When you successfully pulled docker image, now you can run image.
    docker run -it amrit3701/freecad-cli:lastest bash
    


Additional information

Extend docker image

You can also extend this docker images to add additional dependencies for your project. For eg

# Dockerfile

FROM amrit3701/freecad-cli:lastest

# Add additional dependencies

# pip3.8 install <some_package>

Import FreeCAD in Python

After running docker image, just run Python.

$ docker run -it amrit3701/freecad-cli:lastest bash
root@f0ec904cf9b9:/# python3.8
Python 3.8.5 (default, Jul 20 2020, 19:48:14)
[GCC 7.5.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import FreeCAD
>>> import Part
>>> import Draft
>>> import Arch

Launch FreeCADCmd

To launch FreeCAD inside docker image, just run FreeCADCmd command.

Discussion

FreeCAD forum thread: https://forum.freecadweb.org/viewtopic.php?f=8&t=45877