OctoPrint is the snappy web interface for your 3D printer!
JavaScript Python HTML CSS Shell
Latest commit 6393de8 Jan 25, 2017 @foosel Preparing release of 1.3.1
Failed to load latest commit information.
.github Preparing release of 1.2.16 Sep 23, 2016
.tx Updated transifex config file to point to new translation directory Jun 2, 2015
docs Simplified install process on Mac Jan 13, 2017
scripts Fix BASEDIR & CONFIGFILE eval in init script & param order Dec 16, 2016
src Fixed passing of "daemon" legacy parameter on CLI Jan 20, 2017
tests Various analysis queue fixes Jan 12, 2017
translations Update german translation Jan 12, 2017
.editorconfig Added an EditorConfig file May 29, 2015
.gitattributes Marked some paths for github's linguist Sep 23, 2016
.gitignore python 3 changes exceptions, queue and asesrtEqual Jul 15, 2016
.travis.yml Travis: Let's see if we can't get the git depth upped a bit Oct 23, 2015
.versioneer-lookup Upped version numbers for branches Dec 8, 2016
AUTHORS.md Added @noahsmartin to AUTHORS Jan 13, 2017
CHANGELOG.md Preparing release of 1.3.1 Jan 25, 2017
CONTRIBUTING.md Preparing release of 1.3.1 Jan 25, 2017
LICENSE Moved LICENSE file to root directory to make it more visible. Added h… Jan 19, 2013
MANIFEST.in Merge branch 'maintenance' into devel Jul 18, 2016
README.md Update command line examples in README Jan 9, 2017
SUPPORTERS.md Preparing release of 1.3.1rc1 Jan 13, 2017
THIRDPARTYLICENSES.md Fixed sorting in 3rd party licenses Jan 13, 2017
babel.cfg Webassets are now written to ~/.octoprint/generated Jun 3, 2015
requirements.txt Removed accidentally committed line in requirements.txt Mar 12, 2015
run changed magic line from python->python2 Sep 17, 2015
setup.cfg We want pep440-post by default Oct 23, 2015
setup.py Simplified install process on Mac Jan 13, 2017
versioneer.py Fixed an issue with versioneer detecting sdist version Nov 7, 2016



OctoPrint provides a snappy web interface for controlling a 3D printer (RepRap, Ultimaker, ...). It is Free Software and released under the GNU Affero General Public License V3.

Its website can be found at octoprint.org.

The documentation is located at docs.octoprint.org.

The official plugin repository can be reached at plugins.octoprint.org.

OctoPrint's development wouldn't be possible without the financial support by its community. If you enjoy OctoPrint, please consider becoming a regular supporter!


You are currently looking at the source code repository of OctoPrint. If you already installed it (e.g. by using the Raspberry Pi targeted distribution OctoPi) and only want to find out how to use it, the documentation and the public wiki might be of more interest for you. You might also want to subscribe to the mailing list or the G+ Community where there are other active users who might be able to help you with any questions you might have.


Contributions of all kinds are welcome, not only in the form of code but also with regards to the official documentation or the public wiki, support of other users in the bug tracker, the Mailinglist or the G+ Community and also financially.

If you think something is bad about OctoPrint or its documentation the way it is, please help in any way to make it better instead of just complaining about it -- this is an Open Source Project after all :)

For information about how to go about contributions of any kind, please see the project's Contribution Guidelines.


Installation instructions for installing from source for different operating systems can be found on the wiki.

If you want to run OctoPrint on a Raspberry Pi you might want to take a look at OctoPi which is a custom SD card image that includes OctoPrint plus dependencies.

The generic steps that should basically be done regardless of operating system and runtime environment are the following (as regular user, please keep your hands off of the sudo command here!) - this assumes you already have Python 2.7, pip and virtualenv set up on your system:

  1. Checkout OctoPrint: git clone https://github.com/foosel/OctoPrint.git
  2. Change into the OctoPrint folder: cd OctoPrint
  3. Create a user-owned virtual environment therein: virtualenv venv
  4. Install OctoPrint into that virtual environment: ./venv/bin/python setup.py install

You may then start the OctoPrint server via /path/to/OctoPrint/venv/bin/octoprint, see Usage for details.

After installation, please make sure you follow the first-run wizard and set up access control as necessary. If you want to not only be notified about new releases but also be able to automatically upgrade to them from within OctoPrint, take a look at the documentation of the Software Update Plugin and at its settings.


OctoPrint depends on a couple of python modules to do its job. Those are automatically installed when installing OctoPrint via setup.py:

python setup.py install

You should also do this every time after pulling from the repository, since the dependencies might have changed.

OctoPrint currently only supports Python 2.7.


Running the setup.py script via

python setup.py install

installs the octoprint script in your Python installation's scripts folder (which depending on whether you installed OctoPrint globally or into a virtual env will be on your PATH or not). The following usage examples assume that said octoprint script is on your PATH.

You can start the server via

octoprint serve

By default it binds to all interfaces on port 5000 (so pointing your browser to will do the trick). If you want to change that, use the additional command line parameters host and port, which accept the host ip to bind to and the numeric port number respectively. If for example you want the server to only listen on the local interface on port 8080, the command line would be

octoprint serve --host= --port=8080

Alternatively, the host and port on which to bind can be defined via the configuration.

If you want to run OctoPrint as a daemon (only supported on Linux), use

octoprint daemon {start|stop|restart} [--pid PIDFILE]

If you do not supply a custom pidfile location via --pid PIDFILE, it will be created at /tmp/octoprint.pid.

You can also specify the configfile or the base directory (for basing off the uploads, timelapse and logs folders), e.g.:

octoprint serve --config /path/to/another/config.yaml --basedir /path/to/my/basedir

See octoprint --help for further information.

OctoPrint also ships with a run script in its source directory. You can also invoke that to start up the server, it takes the same command line arguments as the octoprint script.


If not specified via the commandline, the configfile config.yaml for OctoPrint is expected in the settings folder, which is located at ~/.octoprint on Linux, at %APPDATA%/OctoPrint on Windows and at ~/Library/Application Support/OctoPrint on MacOS.

A comprehensive overview of all available configuration settings can be found in the docs. Please note that the most commonly used configuration settings can also easily be edited from OctoPrint's settings dialog.

Special Thanks

Cross-browser testing services are kindly provided by BrowserStack. Profiling is done with the help of PyVmMonitor.