Download & Setup OctoPrint
- OctoPrint plus its dependencies
- MJPG-Streamer for live viewing of prints and timelapse video creation, compatible with various USB webcams and the Raspberry Pi camera
Recommended hardware: Raspberry Pi 3B, 3B+, 4B or Zero 2. Expect print artifacts and long loading times with other options, especially when adding a webcam or installing third party plugins. Setups not using recommended hardware are not officially supported.
Please note that the Raspberry Pi Zero and Zero W are not recommended explicitly since severe performance issues were observed, caused by the WiFi interface when bandwidth is utilized (e.g. the webcam is streamed), negatively impacting printing quality. See also here. The Zero 2 however is recommended.
OctoPi is available through the Raspberry Pi Imager, which you can use to download and setup OctoPi. You can install it yourself, or alternatively simply buy one of the available
Here’s how to get started installing OctoPi:
If you haven’t already, download and install Raspberry Pi Imager on your computer
Find the OctoPi image under ‘Choose OS’, by selecting ‘Other Specific Purpose OS’ followed by ‘OctoPi’ and then the ‘stable’ version.
- Open advanced options by using the keyboard shortcut
xto configure your Wifi connection:
- Set your SSID, password and WiFi country using the options:
Install the image to your SD card, then plug everything in to your Raspberry Pi and boot it up. Do not format the SD card after installing, even if prompted to do so. This will break the installation and you will have to start over!
Log into your Pi via SSH (it is located at
octopi.localif your computer supports bonjour or the IP address assigned by your router), default username is
pi, default password is
sudo raspi-config. Once that is open:
- Change the password via “Change User Password”
- Optionally: Change the configured timezone via “Localization Options” > “Timezone”.
- Optionally: Change the hostname via “Network Options” > “Hostname”. Your OctoPi instance will then no longer be reachable under
octopi.localbut rather the hostname you chose postfixed with
.local, so keep that in mind.
You can navigate in the menus using the arrow keys and
Enter. To switch to selecting the buttons at the bottom use Tab.
You do not need to expand the filesystem, current versions of OctoPi do this automatically.
You also do not need to manually enable the RaspiCam if you have one, that is already taken care of on the image as well.
- Access OctoPrint through
http://<your pi's ip address>.
httpsis available too, with a self-signed certificate (which means your browser will warn you about it being invalid).
Alternative Wifi Setup
If you aren’t using Raspberry Pi Imager, then you can also setup the Wifi connection using the
on the root of the installed card when using it like a thumb drive.
Important: Do not use WordPad (Windows) or TextEdit (MacOS X) for this, those editors are known to mangle
the file, making configuration fail. Use something like Notepad++, Atom or VSCode instead or at the very
least heed the warnings in the file.
Please also refer take a look at the full WiFi setup guide in the FAQ that also includes troubleshooting tips.
Thomas Sanladerer created a great video guide on how to get OctoPi 0.18 up and running.
Raspberry Pi Imager will download the latest version of OctoPi for you, but if you want to download the images yourself you can do so here.
Raspberry Pi 3B, 3B+, 4B or Zero 2 strongly recommended, Raspberry Pi Zero/Zero W not officially supported!
Image compatible with Raspberry Pi A, B, A+, B+, 2B, 3A+, 3B, 3B+, 4B 1/2/4/8GB, 400, Zero, Zero W and Zero 2.
- The MagPi issue #36 contains a “Getting Started” guide on pages 50-51. You can find an excerpt here (MagPi License: CC BY-NC-SA).
- For customizing OctoPi, take a look at CustoPiZer.
- Scripts to build the image yourself can be found in OctoPi’s Github repository.
The generic setup instructions boil down to
- Installing Python 3, including pip.
- Creating a virtual environment somewhere:
python -m venv OctoPrint
- Installing OctoPrint into that virtual environment:
OctoPrint/bin/pip install OctoPrint
- OctoPrint may then be started through
./OctoPrint/bin/octoprint serveor with an absolute path
More specific setup instructions for the most common runtime environments can be found below.
For installing OctoPrint on Linux, please take a look at the setup instructions for Raspbian on the forum. They should be pretty much identical on other Linux distributions.
For installing the OctoPrint server on a Windows system, please take a look at the setup instructions for Windows on the forum.
For installing the OctoPrint server on a Mac, please take a look at the setup instructions for MacOS on the forum.