Featured image of How to Set Up OctoPrint on Raspberry Pi 3 B+ – 3 Easy Steps
Eyes Everywhere

How to Set Up OctoPrint on Raspberry Pi 3 B+ – 3 Easy Steps

Picture of David Contreni
by David Contreni
Sep 28, 2019

Jump into this guide to find out how to install OctoPrint on the Raspberry Pi 3 B+, one of the most popular Pi boards available right now.

OctoPrint & the Raspberry Pi 3 B+ Why the Pi?

Octoprint could have stopped this.
Octoprint could have stopped this. (Source: techly.com.au)

A Raspberry Pi 3 B+ running OctoPrint is an upgrade or modification that virtually any 3D printer can benefit from. Unless you just pulled your first 3D printer out of the box yesterday, you’ve probably heard of OctoPrint.

With OctoPrint, you can observe and control your 3D printer remotely. For instance, you can automatically take still shots of every layer and turn them into a video of a model that seems to grow by itself. You can also control lights, and even shut down your 3D printer after the job is done.

So, what are you afraid of? It’s only a Raspberry Pi 3B+ running some software! If you’ve already got a Raspberry Pi 3 B+, it won’t cost you a thing. Even if you don’t, the upgrade could pay for itself the first time you don’t lose a whole role of carbon fiber filament on a failed print.

So let’s find out how to make this upgrade!


OctoPrint & the Raspberry Pi 3 B+ What You'll Need

Everything you need.
Everything you need. (Source: David Contreni / All3DP)

Now that you’ve decided to take the plunge and install OctoPrint on a Raspberry Pi 3 B+, you’ll need a few things:

  • Raspberry Pi: We recommend a Raspberry Pi 3 B+, even over the new Raspberry Pi 4. After all, the Raspberry Pi 3 B+ is quite capable and fits more of the currently available 3D printed cases.
  • Power supply: Rated at 5 V and 2.5 A and terminating in a micro USB plug.
  • Micro SD card: 16 GB or better, and (possibly) an adapter that you can use to plug it into a computer.
  • Standard USB cable: To connect your 3D printer’s control board to the Raspberry Pi.
  • Raspberry Pi USB camera: Optional, but highly recommended. This will allow you to monitor your prints.

You’re also going to need some software. We like it free and open-source:

What you won’t need is a keyboard and mouse, monitor and cable, or Raspbian software.

Raspberry Pi 3 Model B+
Check price at:
Raspberry Pi Camera
Check price at:

OctoPrint & the Raspberry Pi 3 B+ Setup

Success is a happy octopus.
Success is a happy octopus. (Source: David Contreni / All3DP)

First, we’ll put the OctoPrint image on your micro SD card using Etcher.

  1. Extract OctoPi and run Etcher.
  2. Click “Select Image”, navigate to the OctoPi image, and select it.
  3. Click “Select Drive”. Your removable drive should appear.
  4. Click “Flash”.
  5. Wait until Etcher reports the job is done.

Next comes network configuration.

  1. While the drive is still in the adapter in your computer, find “octopi-wpa-supplicant.txt” on the boot partition of the new image.
  2. Using the text editor of your choice, uncomment and fill in your network information. “SSID” is the name of your network, and “PSK” is your password. Also, uncomment your country near the bottom of the document.
  3. Eject the micro SD card and insert it into the Raspberry Pi.

A few more simple steps and we’re ready to start it up.

  1. Connect your video camera if you’re using one.
  2. Connect the Raspberry Pi 3 B+ to your 3D printer using the standard USB cable.
  3. Power up the Raspberry Pi and wait a few minutes. Solid red and flickering green lights mean the Raspberry Pi has power and is talking to your network.
  4. Open a browser on your computer and in the navigation tab type in “octopi.local/”.
  5. OctoPrint should open up and display the main user interface.
  6. If you leave the serial port and baud rate alone, it should connect to your printer automatically. Sometimes you might need to change the baud rate. (Try lowering it a step.) Or, select a different port.
  7. You might have to press “Connect” on occasion, but if your printer is on when OctoPrint starts, it will usually connect right away.

If Something Fails…

Setting up OctoPi truly is a simple procedure. But as with just about anything, from time to time, something goes wrong. If you’re having issues, here are some troubleshooting resources:


OctoPrint & the Raspberry Pi 3 B+ Basic Operation

The view from OctoPrint's webcam.
The view from OctoPrint's webcam. (Source: David Contreni / All3DP)

Here’s an overview of the OctoPrint user interface:

  • Across all tabs, information relating to the connection and status of Octoprint is on the left.
  • OctoPrint starts up on the Temperature tab, which will give you important information about the temperature settings and readings. It features a graph that shows the temperature history of your hot end and heated bed.
  • The next tab to the right is the Control tab. This is where you would see the stream from your camera. You can also control your 3D printer from here.
  • G-code Viewer is the next tab. This is where OctoPrint draws the path of each layer.
  • The Terminal tab is where you can view reports from your controller, and send G-code commands directly.
  • If you have a camera installed, in the Timelapse tab, you can configure OctoPrint to automatically create a timelapse video. (But there are actually better ways to do that with the use of plug-ins.)
  • The wrench (or spanner) icon at the top of the screen is the settings section. We could write a whole article about this, but for all its features, you probably won’t spend much time here unless you need to refer to something.
    • One thing of general importance in this section is the Plug-in Manager. OctoPrint comes with a few plug-ins pre-installed, but there are many more that can be downloaded. If you need a minimal interface for a smartphone, special security, photography controls, or other enhancements, this is the place to look.

Note: This article barely scratches the surface of OctoPrint and its installation on a Raspberry Pi 3 B+. Many of the aforementioned plug-ins could each have an article.

The OctoPi image that we’ve installed here is the easiest and most popular way to get OctoPrint up and running. OctoPrint can run wherever Python can, but its real home is an SBC like the Raspberry Pi 3 B+.

Please feel free to add your experiences and comments below.

(Lead image source: mcfada / Thingiverse)

License: The text of "How to Set Up OctoPrint on Raspberry Pi 3 B+ – 3 Easy Steps" by All3DP is licensed under a Creative Commons Attribution 4.0 International License.

Subscribe to updates from All3DP

You are subscribed to updates from All3DP

You can’t subscribe to updates from All3DP. Learn more… Subscribe

You can’t subscribe to updates from All3DP. Learn more…

Recommended for you