Install OctoPi on Raspberry Pi – OctoPrint Install Guide

OctoPrint is an open-source project that adds a lot more functionality for your 3D printing needs. From remote monitoring and better time estimations to gorgeous time-lapses, OctoPrint is the best tool to use in order to improve your 3D printing experience.
In this article, I will show you in detail how to install OctoPi on Raspberry Pi.

Why install OctoPi ?

OctoPi is a distribution of Raspbian maintained by Guy Sheffer with OctoPrint already installed and configured, made specifically for the Raspberry Pi.
The main reason why you would want to install OctoPi is the possibility of adding a webcam in order to remotely monitor your prints. OctoPrint can be integrated with Telegram or Slack allowing for remote communication with your 3D printer without the need of opening firewall ports and exposing OctoPrint to the internet.  Besides this, you also get the web controls for your printer allowing you to move the print head along all axes.

With OctoPi you also get access to the terminal allowing custom GCODE commands to be run on the printer. This feature will help a lot with PID Tuning and extruder calibration.
Another good reason to install OctoPi is the possibility of creating time-lapses with your print with the Octolapse plugin.
A complete feature list is available on the OctoPrint website.


In order to install OctoPi you will need the following:

    1. Raspberrpy Pi (Raspberry Pi 3B, 3B+ or 4 is strongly recommended for best performance).
    2. 16 GB MicroSD card.
    3. Webcam for monitoring your prints (optional).

Install OctoPi image on SD Card

  1. Download the OctoPi image and unzip the archive.
    Download OctoPi
  2. Download and install Win32 Disk Imager.
    Download Win32 Disk Imager
  3. Open Win32 Disk Imager, load the .img file unzipped in step 1 and select your SD card drive letter. Click on Write to begin installing OctoPi on the SD card. This process will take a few minutes, depending on the speed of your SD card.
    Write the img file to the sd card
  4. After the OctoPi image has been written to the SD card, you can remove the SD card and insert it in your Raspberry Pi
  5. Power On the Raspberry Pi and wait 5 minutes for the operating system to boot and start listening to SSH connections.

Find the IP of your OctoPi install

In order to connect to your OctoPi install, you first need to find your the IP address your Raspberry Pi received from the DHCP server.

  1. Press Windows Key + R at the same time to open Run.
  2. Type cmd.exe then press Enter to open Command Prompt
    Open Command Prompt
  3. In the Command Prompt window, type ping octopi.local -4 and press enter. This will return the IP of your Raspberry Pi.Find OctoPi IP address

Connect to OctoPi via SSH

Now that we discovered the IP of our OctoPi install, we can connect to it via SSH to change the root password and apply updates.

  1. Download Putty , enter the IP of your Raspberry Pi then click Open
    Connect to OctoPi with Putty
  2. In the Login prompt, you need to enter the credentials for OctoPi. The default user is pi and the password is raspberry. Please note that the password will not be shown when typing.
    Login to OctoPi
  3. If you enter the credentials correctly, the servers’ SSH fingerprint prompt will show up. Click on Yes.
    SSH Fingerprint Prompt
  4. Now you are in the SSH console of your OctoPi install.OctoPi Install SSH Console

Change OctoPi default password and apply updates

  1. Type sudo raspi-config and press Enter.
    OctoPi raspi config
  2. In the Login prompt, enter the same password used before – raspberry.
    Emter OctoPi password
  3. Select Change User Password and press Enter.
    Change User Password
  4. You will be asked to enter a new password. Press Enter.
    Change password prompt
  5. Enter your new password twice.
    Enter your new password
  6. If the new passwords match, you will receive a confirmation for the password change
    Password confirmation
  7. Next. select Localisation Options and press Enter.
    Octopi Localisation Options
  8. Select Change Timezone and press Enter.
    Change OctoPi Timezone
  9. Chose your Geographic Area and press Enter.
    Select Geographic area for Octopi
  10. Select your Time zone and press Enter.Select Time zone for OctoPi

Configure OctoPrint

  1. Open a browser and enter the IP of your OctoPi instance then click Next to begin the OctoPrint Setup.
    Connect to Octoprint with your browser
  2. Enter a username and password to secure your OctoPrint instance, click on Keep Access Control Enabled then click Next.
    Secure Octoprint instance and enable Access Control in Octopi
  3. Choose whether to Enable or Disable Anonymous Usage Tracking then click Next.
    Select your Anonymous Usage Tragink option for Octoprint
  4. Click on Test host & port then clock on Enable Connectivity Check, then click Next.
    Configure Octoprint Conectivity Check
  5. Choose whether to Enable or Disable Blacklist Processing. I recommend enabling this feature. After selecting an option, click Next.
    Enable Plugin Blacklist Processing in Octoprint
  6. Enter a name and a model for your printer profile, then click Next.
    Setup Octoprint printer profile for Octopi
  7. Enter your print volume according to your printer, then click Next.
    Change printer volume according to your printer in OctoPi
  8. Click Finish to complete the OctoPrint setup process.
    Complete the OctoPi Setup

Octopi setup is complete!Octoprint Setup complete

That’s it. Now you can connect your printer to the Raspberry Pi, and click Connect. Your printer will be connected to Octoprint and the Temperature graph will show the values read from the printer.
Go to the settings and install some plugins to add new features in OctoPrint. I will follow up with another article soon, with my favorite plugins for Octoprint.
If you encounter any issues during the Octopi install process, let me know in the comment section and I will do my best to help you out.

Liked it? Take a second to support 3DPrintBeginner on Patreon!
become a patron button

You may also like...