The ready-to-go Raspberry Pi image with OctoPrint
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:
MD5sum of the .zip:
Compatible with Raspberry Pi A, B, A+, B+, B2, 3, Zero and Zero W.
Additional mirrors can be found here:
- Mirror #1 (also includes nightly builds)
How do I set it up?
- Download the image via the button above.
Unzip the zipped image and install the contained
.imgfile to an sd card like any other Raspberry Pi image
Configure your WiFi by editing
octopi-network.txton the root of the flashed card when using it like a thumb drive
- Boot the Pi from the card
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 "raspberry". Change the password using the
passwdcommand. 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:
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?
- Getting started with OctoPrint on the Raspberry Pi 2! [2016 edition] by Thomas Sanladerer
- 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).
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.