The ready-to-go Raspberry Pi image with OctoPrint

Created & maintained by Guy Sheffer and the community

What is OctoPi?

OctoPi is a Raspberry Pi distribution for 3d printers. Out of the box it includes:

  • the OctoPrint host software including all its dependencies and preconfigured with webcam and slicing support,
  • mjpg-streamer for live viewing of prints and timelapse video creation with support for USB webcams and the Raspberry Pi camera and
  • CuraEngine 15.04 for direct slicing on your Raspberry Pi.

Where can I get OctoPi?

You can download the latest stable build via this button:

  Download OctoPi 0.14

MD5sum of the .zip: 52c855c9bcc88fd3bf81bbe8e58a2e4c

Compatible with Raspberry Pi A, B, A+, B+, B2, 3, Zero and Zero W.

Additional mirrors can be found here:

How do I set it up?

  1. Download the image via the button above.
  2. Unzip the zipped image and install the contained .img file to an sd card like any other Raspberry Pi image
  3. Configure your WiFi by editing octopi-network.txt on the root of the flashed card when using it like a thumb drive
  4. Boot the Pi from the card
  5. Log into your Pi via SSH (it is located at octopi.local if your computer supports bonjour or the IP address assigned by your router), default username is "pi", default password is "raspberry". Change the password using the passwd command. You do not need to expand the filesystem, current versions of OctoPi do this automatically.

OctoPrint is located at http://octopi.local and also at https://octopi.local. Since the SSL certificate is self signed (and generated upon first boot), you will get a certificate warning at the latter location.

If a USB webcam or the Raspberry Pi camera is detected, MJPG-streamer will be started automatically as webcam server. OctoPrint on OctoPi ships with correctly configured stream and snapshot URLs pointing at it. If necessary, you can reach it under http://octopi.local/webcam/?action=stream and SSL respectively, or directly on its configured port 8080: http://octopi.local:8080/?action=stream.

CuraEngine 15.04 is installed and OctoPrint ships pre-configured with the correct path to utilize it for on-board-slicing. Just import a Cura Slicing Profile in OctoPrint's settings and start slicing directly on your Pi.

Are there further resources to get going?


I want to build my own version of OctoPi

No problem, OctoPi is Open Source licensed under GPLv3. You can find the scripts used to build the image in the official Github repository.

Fork me on GitHub