Skip to main content

How to check that the 3DPrinterOS Client RPi Image is Booting Correctly

Written by Illia Nazarko

Raspberry Pi Boot Troubleshooting

1. Power Supply:​

  • Ensure the power supply is connected properly by checking the LEDs on the RPi.​

  • If the red LED is not lit (and not blinking), the RPi is not receiving power.​

  • A blinking red LED indicates a boot cycle or a power level warning.​

  • A green LED indicates CPU activity. It should blink inconsistently during boot and less frequently afterward if the software runs correctly.​

  • A dim green LED means no boot or a crash.

2. Fail-Safe Measure:

  • Connect the RPi to your router via an ethernet cable to exclude any possible WiFi issues.

3. Scan Your LAN for the RPi’s IP:​-Windows PC or 3DPrinterOS Client Web UI:

Use it to detect all machines running 3DPrinterOS in your LAN. Open the Web UI of the 3DPrinterOS Client running on your local machine by typing 127.0.0.1:8008 in your browser’s address bar and pressing Enter.

In the Web UI, click "Settings", then "Detect clients in LAN" and view the scan results for the correct IPs of all other available 3DPrinterOS Clients.​

  • Third-Party Network Scanner: Use software like nmap to identify an RPi running 3DPrinterOS by looking at addresses with ports 22 (SSH) and 80 (HTTP) open.​

  • Network Router Admin Pages: Access your network router's admin pages to get the RPi's IP.

4. Check the RPi’s Web UI:​

  • With the correct IP, type it into the address bar of a browser on a machine in the same LAN as the RPi running 3DPrinterOS.

5. Authentication:​

  • A remote Web UI may ask for authentication. Enter your SSH credentials into the fields of the 3DPrinterOS client authentication page.

6. Post-Authentication:​-After authentication, you can bind an image to your 3DPrinterOS cloud account or use it in Offline mode.


​7. Unable to Reach the Web UI:

  • Try to connect via SSH. On GNU/Linux or MacOS, type into your terminal: ssh <ip_of_rpi_in_your_LAN>. On Windows, install Putty, enter the RPi’s IP, and choose SSH.​-Also, if there are troubles with the SSH connection or detecting the RPI's IP address, as an alternative to SSH, you could connect a display (via HDMI) and a keyboard, and try to boot the RPI.

8. Check 3DPrinterOS Client Status:​

  • After logging into the RPi through SSH, check the 3dprinteros-client status by typing: systemctl status 3dprinteros.​

  • You can also retrieve logs located in /home/printeros/.3dprinteros/3dprinteros_client.log and /home/printeros/.3dprinteros/critical_errors.log.

Send the status, logs, and a description to issues@3dprinteros.com. ​Zipped logs are much appreciated.

Finding your Raspberry Pi host in the Cloud

To see your hosts and the printers connected to each one, open the Printers page, click the filter icon in the top right corner and turn on Show hosts. Each host then appears as a group with its printers underneath.

To find the Pi's IP address, use Detect clients in LAN in the Client web interface settings as described in step 3, or look the Pi up in your router. If you cannot reach the Pi over the network, connect an HDMI screen and a keyboard and log in with the SSH credentials from the email you received with the image.

Wi-Fi on the host image

The Wi-Fi name and password are set when you generate the image under Printers, Add Printer. Leave them empty to use Ethernet. If the Pi has trouble with Wi-Fi, connect it with Ethernet to rule the network out.

Hosts and printers you no longer use

The Edit button on a host only changes its title and colour. To remove a printer, click the three-dot menu next to it, choose Printer settings, type your email under Delete and click Delete this Printer.

Did this answer your question?