How to install the 3DPrinterOS Client on my Raspberry Pi or Radxa?
3DPrinterOS Client connects your 3D Printer to the Cloud.
It supports all platforms, but most users prefer to run it on the RPi or other SBC because they don't need to keep their PC close to a 3D printer.
Supported SBC: Raspberry Pi (2,3,4, 5 and Zero 2W), Raspberry Pi ARMv6 (1, Zero 1 W), Radxa Zero, Radxa Rock 4 (A, A+, B, B+, C, and SE), and Radxa Rock 4C+
Requirement for a camera: Pi Camera or USB connected, 640x480 resolution.
⚠️ Important Hardware Note: We strongly advise against using USB cameras with the Raspberry Pi 3 or 3B+. The Pi 3 has a known hardware limitation where activating a camera stream overloads its shared USB/Ethernet bus, causing the 3D printer to disconnect mid-print. If you need camera streaming, we highly recommend upgrading to a Raspberry Pi 4.
3DPrinterOS Client for the SBC is an image of the whole OS with 3DPrinterOS Client running. It uses Arch Linux OS as a base.
Step 1. Generate an image
Go to the Printers and press Add Printer. Add Printer Wizard will start.
1. Choose printer and connection type
2. Choose the Single Board Computer model
Raspberry Pi 3 Users: To ensure maximum print stability and prevent frequent communication pauses, you must select the 32-bit version of the OS (labeled as RaspberryPi (2,3,4,Zero 2 W) with a blue background). The 64-bit version is known to cause communication drops on older Pi 3 hardware.
3. Enter your WiFi Network Name and Password so the image will be connected to your WiFi network straight away. You could leave these fields empty if you are planning to use an Ethernet connection or just want to manually add the WiFi configuration in the future. Click on Generate Image. Do not close the Add Printer Wizard overlay.
The generated image will be sent to your email along with the credentials required to log in to the web Client UI.
Step 2. Install the 3DPrinterOS Client image on the SD card
Prepare your SD Card. Insert it into your computer.
Extract the image file from the downloaded .zip file so you have a .img file.
Flash the image onto the SD Card.
Find How to Flash an SD card in the guides:
Using Windows
Using Mac
Using Linux. Joke? There is no way that you don't know how to flash SD cards if you're on Linux. I'll leave it here, and won't tell anyone.
Step 3. Connect your 3D Printer to the Cloud
Insert SD Card into the Single Board Computer
Turn on the Single Board Computer
Connect the printer to the Single Board Computer
Go back to the Add Printer Wizard overlay that you left on Step 1, item 2.
The Add Printer Wizard will check your printer connection and report the result to you on the same screen
Voila! The printer is ready. You are awesome 👏
Troubleshooting
Nothing happens after you've turned on the RPI?
Make sure your single-board computer is connected to the WIFI network. How?.
The WIFI password was changed.
To find out your Single Board Computer IP Address. Navigate to Printers:
1. Filter.
2. Toggle "Show hosts".
3. See the IP and MAC address of the Single Board Computer attached to the printer.
Read about different ways to find the Single Board Computer's IP address here.
3. Change password settings. Read here
Having an issue? Report a problem