Getting started with OctoPi - The easy route

In this short guide I will cover the simple steps of getting your printer running with OctoPi in less than 10 minutes. OctoPi is a ready to go Rasbian based SD card image with everything you need to make your 3D printer wireless and more accessible.

In my two previous guides(1 2) I went through the steps of setting up OctoPrint manually on a clean Rasbian installation. If you do not care to much about writing stuff in terminals and installing a lot of packages there is another route perfect for you!

You will need

  • Raspberry Pi(any model should be able to do it) 
  • SD card (8GB or larger)
  • SD card reader
  • USB WiFi dongle(or ethernet cable if you want wired connection)
  • Web camera(if you want live view of print and ability to make timelapses)

The installation

You have everything settled? Great let's get going.

First thing you need to do is download the OctoPi image.

Now we need to flash this image to the SD card. On Mac you can use the "Disk Utility", on Linux "gparted" and on Windows by using Win32DiskImager (I'm using Windows in this guide)

Choose the image you downloaded and the SD card you have connected to your computer under "Device". The choose "Write" and wait for it to finish.

If everything went as planned you are now pretty much finished. We only need to do one more thing before powering up the Raspberry Pi.

Open the SD card you just wrote to in a file explorer and locate the file "octopi-network.txt". Open it in a text editor and change the settings according to your network.

For my setup with a WiFi dongle I uncommented(remove #) the following lines and added my networks SSID and password.

iface wlan0 inet manual
wpa-ssid <your SSID>
wpa-psk <your network password>

Starting up Raspberry Pi

Now unmount you SD card and put it into your Pi. Also connect printer and webcam before powering it up. Your printer should now be accessible on the address "octopi.local". But before you start exploring the web interface let us do a few more things.

Open a ssh session on your Raspberry Pi. For Windows you can use Putty. You can now connect to your device by using the hostname(octopi.local) and the standard login(pi,raspberry). First thing we will do is change this password.


You will now be prompted for you existing password and the ability to add a new one. I strongly recommend doing that!

Now lets open that config and do a few more things.

sudo raspi-config

The following window will pop up. 

Select "Expand Filesystem" and hit return. Optionally you can also overclock your Raspberry Pi by selecting "Overclock". I went with the medium setting. Now hit the tab key twice to get to "Finish" and hit return. Your Pi should now reboot.

OctoPrint web interface

We are now ready to open the web interface. On your computer open your favourite browser and navigate to octopi.local. You should be prompted to input a user name and password.( I recommend doing that.) You are now up and running. The rest is configuration of your printer.


I recommend this excellent video by Thomas Sanladerer explaining this same setup with the Raspberry PI 2


fhareide's picture
Last updated: 
29 Dec 2015 - 18:21