Skip to main content

Orange Pi Zero 2 Kit for OctoPrint Setup and Configuration

This guide is intended for users with a varied range of technical experience. If you are a wiz, feel free to disregard the detailed explanations. If you have little experience, follow the instructions and you'll have OctoPrint connected to your 3D printer with a webcam in no time.

What's Included in the Kit​

  • Orange Pi Zero 2
  • Heat Sink with thermal pad
  • USB Hub
  • Case (not recommended - use the printable version)

If possible, do NOT use the stock case included in the kit. The stock case doesn't having sufficient cooling and may cause the CPU to overheat.

Use the printable version instead.

You will also need

  • A high quality SD card (class 10 or better) with at least 8GB of storage
  • An Ethernet cable
  • USB cable to connect your 3D printer to the Orange Pi (comes with most printers)

Prepare the Software​

1. Download the OctoPrint for Orange Pi software​

Download the OctoPrint for Orange Pi software here

  • (Mac) Double click the file once downloaded and drag it into the applications folder to install it. (Windows users can right click the file and click extract to unzip the file)

2. Download Raspberry Pi Imager​

3. Flash the SD card​

  • Open up the Raspberry Pi Imager

  • Click Choose Operating System

  • Select Use Custom at the bottom of the menu

  • Locate the file that you previously downloaded and unzipped and select it.

  • Insert your SD card into the computer.


Use a high-quality, class 10 or better SD card with at least 8GB of storage. If you plan on creating a lot of time-lapses, more storage is recommended.

  • Select the SD card

The SD card will be wiped, so be sure there are no important files on the card.

  • Click Write:

  • Confirm that you are aware the SD card will be erased. You may be asked to enter your administrator password for your computer as well.

The file is large, so it may take a while (up to 40 minutes but likely less) for the software to be installed on the SD card. Grab a coffee, and get the rest of the kit setup while the software is installed on the SD card.

Setup the Hardware​

1. Unbox the Kit​

Unbox your kit and lay out the components:

The kit includes

  • Orange Pi Zero 2
  • Heatsink
  • USB Hub
  • 5V 3A USB C Power Supply
  • USB Webcam
  • Official Orange Pi Zero 2 case (not recommended - use the printable version)

You will also need

  • A high-quality SD card (class 10 or better) with at least 8GB of storage
  • An Ethernet cable
  • A USB cable to connect the Orange Pi to your printer (comes with most printers)

2. Install the heat sink on the Orange Pi Zero 2​

  • Remove one side of the paper backing on the thermal pad and place the pad on the heat sink. Remove the other paper from the other side and place the heat sink on the CPU

3. Put the Orange Pi in the Case​

While putting your Orange Pi Zero 2 is not required, it is recommended to help keep it clean and safe.

As mentioned above, it is not recommended to use the case that is included in the kit due to it's pour cooling capabilities. You can print the case we designed.

If you prefer a different case, we also made a collection on Printables with a few other options that have been tested.

4. Mounting the Camera​

You can mount your camera in many different ways depending on your printer. The best mounting solution depends on how you plan to use the camera with your 3D printer.

For example, If you are simply interested in casually monitoring your 3D prints with a camera, you don't have to consider any extra factors. Simply position your camera any way you like. If you are planning to use your webcam to record timelapse videos or take advantage of Obico's Ai failure detection, you may want to consider the angle of the camera further, it's focus and the lighting conditions. Here are a couple of options for mounting your camera:

  • Print a mount: 3D printing a mount is a great option. Here are a few mounts tested to work with the camera included with the kit.
Webcam MountDescription
Tripod adapter for all webcamsGeneral tripod-mount (ΒΌ-20 thread)
20-20 Extrusion Webcam MountWorks with printed adapter
Ender 3 S1 MountWorks with printed adapter

  • Use a box, cup, or another surface to elevate the camera. Even a box can provide a nice camera view.

Configure Wifi​

Once the Raspberry Pi Imager has finished flashing the OctoPrint software to your SD card, you can remove it from your computer and insert it into the Orange Pi.

1. Connect the Orange Pi to your router.​

We will assume most users will be connecting via Wifi although connection via ethernet is recommended whenever possible.

  • Connect one end of an ethernet cable to the Orange Pi, and connect the other end to a port on your wireless router. Assuming you will connect to wifi, this is only temporary, so do not worry if this is not where you plan to keep the device.
  • Connect the included power supply to the Orange Pi and plug it into an electrical outlet.

2. Find the Pi's Ip Address​

  • Now, you will need to find the IP address of your Orange Pi. This can be done in multiple ways. The easiest way is to connect to your router's admin portal.

If you have an internet provider such as Verizon or Xfinity, instructions for connecting are on the router. In this example, I will access the Verizon wireless router settings by entering the admin username and password found on my router at The admin username and passwords are often different from the wifi username and password.

  • Under Devices, find the device named orangepizero2. For Verizon routers, the IP address can be found by clicking the gear icon for a particular device.

  • You are looking for the IPv4 Address. Once you have found it, write it down or copy and paste it into your notes for easy reference.

If you are having trouble finding the IP address for your Orange Pi, there are a few other ways to find it.

  • For Windows users, download Angry IP Scanner, a free software, and use it to scan for IP addresses. You are looking for the one that says orangepizero2

  • Mac users can follow a similar process by downloading Lan Scan, a free IP scanner for mac.


If you are not planning to configure wifi, you can skip the rest of this section and go to the Connecting to OctoPrint section.

3. SSH into Your Orange Pi​

  • Now, open a terminal window. For Mac users, Terminal can be found in your applications Windows users will find the Command Prompt in programs.

  • SSH into your Orange Pi. SSH is a secure way to access network services securely over an unsecured network. Type the following command:

ssh pi@your-ip-address
  • Enter the password. The password is orangepi. You will not see the letters as you type the password, but they are still being entered.

  • Hit enter to confirm the password. You will then be greeted with the Opi Zero2 logo confirming you are logged in.

4. Connect to your wireless network​

  • Enter the following command to open up the network configuration menu. You can simply copy and paste the command into the terminal and then hit enter on your keyboard to execute the command.

  • Use the arrow keys on your keyboard to highlight Activate a connection and then use the cursor to highlight OK and click enter.

  • Use the arrow keys again to highlight your wifi address name, and then hit enter on your keyboard.
  • Enter the password for your wifi as it appears on your router. Hit enter to confirm.

  • You can verify your wifi has been connected successfully when the upper right indicator switches from \<activate> to \<deactivate>. Once confirmed, move the arrow key to back and hit enter.

5. Find your Wireless IP address​

  • Next, lets get the wireless ip address that was assigned to your orangepi. Enter the following command and hit enter.
sudo ifconfig -a
  • In the output, find the line that starts with wlan0: and note the IP address next to inet. Write it down or store it in your notes for easy reference.

Connect the Orange Pi to your printer​

1. Move the Pi to it's permanent location​

  • Disconnect the Orange Pi from the ethernet cable, and move it to where you plan to connect it with your printer.

2. Connect the Hardware​

  • Plug USB hub cable into the orange pi.
  • Plug the camera into the USB hub
  • Plug the Printer cable into the USB hub.
  • Plug the power cable into the Orange Pi and into the electrical outlet
  • Plug the USB printer cable into the printer with the printer on.

Connect to OctoPrint​

1. Access the OctoPrint User Interface​

  • Open an internet browser and enter the IP address you just found into the URL bar. You will be greeted with the OctoPrint Setup Wizard.

2. Complete the Setup Wizard​

  • Follow the instructions on the screen to complete the setup wizard such as creating an account.

  • Under Defauilt Printer Profile, enter the origin location (usually lower left), whether or not it has a heated bed, and the size of your printers build volume. These settings won't affect your prints, but they help enhance the overall user experience.

  • Click Finish, and you will be sent to the OctoPrint User interface.
  • Click Connect on the left to connect your 3D printer to your Orange Pi Zero 2.
  • Click Control on the upper tab to see your webcam view.

That's it! You have successfully connected to OctoPrint!

Configure Obico for OctoPrint - optional but encouraged :)​

Obico for OctoPrint extends OctoPrint's capabilities:

  • Monitor and control your 3D printer from anywhere on any device - Use the Obico mobile app on the go, or access the full OctoPrint interface from anywhere with Obico's Tunneling feature.
  • Get added peace of mind with Ai failure detection. Obico watches your prints for you and can alert you through your favorite notification service when a failure is detected. Fully configurable to get notified or pause the print when a failure is detected.
  • Start, stop pause and cancel prints on the go from anywhere.
  • Check in on your prints on the go with high quality webcam streaming


This guide assumes you are connecting to the Obico Cloud. If you are connecting to a self-hosted Obico Server, you will need to use the address of your self-hosted server.

Hardware requirements​

Before you start, make sure:

  • OctoPrint is installed and set up correctly. The easiest way to set up OctoPrint is to get a Raspberry Pi and follow this guide.
  • A webcam is set up for your printer and connected to OctoPrint. The 3D Printing Zone has an excellent video for it.
  • There is sufficient lighting to illuminate the printing area of your printer. If your printer is in a lighted room, you are probably fine. If you'll print with light off, you will need to make sure the printing area is illuminated when your printer is printing. A LED strip or small LED lamp will do the trick.

Step 1: Access "Obico for OctoPrint" plugin wizard.​

  1. Restart OctoPrint by clicking the power button
  2. Click Restart OctoPrint. Wait for OctoPrint to reload. 1.The Obico plugin setup wizard should popup once OctoPrint reloads. If it doesn't open automatically, open up the OctoPrint settings menu by clicking the gear icon. Then find Obico for OctoPrint in the menu, and click run setup wizard

Install the Plugin

Step 2: Sign up for an Obico account.​


Follow instructions in the "πŸ“± Mobile App" tab if you are using the Obico mobile app, or the "🌐 Web App" tab if you are using the web app.


Your Obico account is the same for the mobile app and the web app. If you sign up for an account using the mobile app, you can sign in to the web app later with the same email and password. And vice versa.


All functions are available equally in the mobile and the web app. However, with the mobile app, you can receive push notifications on your phone to easily track the print progress, and get alerted in case a failure is detected.

  1. Download the Obico app from the Apple App Store or Google Play Store.
  2. Open the mobile app. Click through the first time tour and then tap β€œLet’s Go!”.
  3. Simply tap "YES!" on the "Hardware Required" screen.
  4. Tap "Sign Up/Sign In" button to proceed to the sign up/sign in screen.
  5. Sign up with your email, Google or Facebook account. If you have already registered, click the "Sign In" button and sign in to your account.

If you are connecting to a self-hosted Obico Server, press the wrench icon (πŸ”§) on the top-left corner of the sign-up screen to change the server address.


If you are phone or computer is one the the same local network as your OctoPrint is, the Obico app can find your OctoPrint automatically. This is the easiest way to link printer to your Obico account.

  1. Press "Link Printer" button on the welcome screen. If you don't see that screen, tap the menu icon (☰) on the top-left corner, and select "Link New Printer".
  2. Choose "OctoPrint" on the next screen.
  3. Assuming you have followed the previous steps and installed the plugin, you can simply click the "Yes, plugin is installed" button.
  4. The app will start scanning for the OctoPrint connected to the same local network.
  5. If the OctoPrint is found, simply click the "Link" button and the app will do the rest for you.

    If, however, the app can't find your OctoPrint after 1 minute of scanning, you need to follow the Manual Setup Guide to link your OctoPrint using a 6-digit code.

6. Optionally, you can now give your printer a name. If you skip this step, your printer will have the default name "*My Awesome Cloud Printer*".

What's next?​

Check out your printer feed!​

Press "Go Check Out Printer Feed!" to see everything you care about your printer: the webcam feed, heater temperature, time remaining on the print job, and more! Remember, you can see your printer feed anywhere you go, as long as you have an internet connection on your phone!

Test the magical failure detection!​

AI-powered failure detection sounds too magical to be true? See the magic in action for yourself.

Change printer settings.​

The default settings for your printer in Obico are the ones that most users find the most reasonable. But feel free to tweak them to your liking:

  • Change notification settings (mobile app only). By default you receive push notifications when a possible print failure is detected. You will also get status update on your lock screen when your printer is printing. But you can choose to receive a lot more.
  • Change printer settings, such as if Obico should pause your printer when a failure is detected.