Articles on: Troubleshooting

Troubleshooting Klipper/Moonraker setup with SimplyPrint

Having trouble setting up your Klipper-powered printer with SimplyPrint? This guide covers the most common issues and how to fix them.

This guide is specifically for Klipper/Moonraker-based printers (printers using Mainsail, Fluidd, or Moonraker directly). For OctoPrint issues, see Printer in setup isn't detected / can't find setup code.

Moonraker version is too old

SimplyPrint requires Moonraker v0.8.0 or newer (released Feb 2023). If your version is older, the [simplyprint] component won't be available.

How to check your Moonraker version:

In Mainsail: Go to Machine > Update Manager
In Fluidd: Go to Settings > Software Updates
Or visit http://YOUR_PRINTER_IP:7125/server/info in your browser

How to update Moonraker:

In Mainsail or Fluidd, open the Update Manager / Software Updates section
If a Moonraker update is available, click Update
Wait for the update to complete and Moonraker to restart

Be careful with updates on non-stock Klipper printers. Some manufacturers ship modified firmware that may break if you update Moonraker through the web interface. If you're unsure, check your printer manufacturer's documentation first.

If you can't update through the web interface, and you have SSH access to your printer, you can use our moonraker-sp.sh script as a fallback (see "Universal SSH fallback" section below).

`[simplyprint]` component not found

After adding [simplyprint] to your moonraker.conf and restarting Moonraker, the component should be recognized. If it isn't:

Check the file location. Some printers have multiple Moonraker config files. Look for:

moonraker.conf
moonraker.generated.conf
Files in /home/pi/printer_data/config/ or /data/moonraker/ or /usr/data/moonraker/

Make sure the syntax is correct. It must be exactly [simplyprint] on its own line - no extra spaces, no typos.
Restart Moonraker after saving. In Mainsail, go to Machine > Power > Moonraker restart. In Fluidd, go to Settings > Restart Moonraker.
Check if your Moonraker is official. Some manufacturers ship a "forked" (modified) version of Moonraker where SimplyPrint support has been removed. This is common on printers with Makerbase mainboards (Elegoo Neptune 4 series, Qidi Tech, Comgrow T300).

If your Moonraker is a manufacturer fork and doesn't support [simplyprint], see the "Makerbase-powered printers" section below.

Can't find the setup code

After enabling SimplyPrint, you need a 4-letter setup code to link your printer.

Where to find it:

Mainsail/Fluidd: Check the notification bell (top right). There should be a SimplyPrint announcement with the code.
Moonraker web UI: Visit http://YOUR_PRINTER_IP:7125 - the announcements section should show the setup code.
SimplyPrint panel: Check the Pending Printers section - your printer may have been auto-detected.

If the code doesn't appear:

Make sure you saved moonraker.conf AND restarted Moonraker
Verify Moonraker is actually running (can you load Mainsail/Fluidd?)
Check that [simplyprint] is in the correct config file
Try restarting the entire printer (power off, wait 10 seconds, power on)

For more details, see Printer in setup isn't detected / can't find setup code.

SSL certificate errors

If you see errors like ERROR: The certificate of 'download.simplyprint.io' is not trusted while running scripts on your printer, the system clock is probably wrong.

Fix it:

sudo date -s 'YYYY-MM-DD'

Replace YYYY-MM-DD with today's date. This is especially common on Makerbase-powered printers (Qidi Tech, Elegoo Neptune 4).

Makerbase-powered printers

Printers with Makerbase (MKS) mainboards - including the Elegoo Neptune 4 series, Qidi Tech (X-Smart 3, X-Plus 3, X-Max 3, Q1 Pro, Plus4), and Comgrow T300 - ship with an outdated or modified Moonraker that doesn't include SimplyPrint support.

The regular Klipper setup won't work on these printers. Instead, use our dedicated setup guides:

Or see our detailed Makerbase helpdesk article for step-by-step instructions. Have a different Makerbase-powered printer? Use the general Makerbase guide.

These guides use a moonraker-sp.sh script that installs a fresh Moonraker instance with SimplyPrint support via SSH, without modifying your existing setup.

Universal SSH fallback: moonraker-sp.sh

If none of the above solutions work and you have SSH access to your printer, you can use our installer script as a last resort. This works on any Klipper printer - not just Makerbase-powered ones.

When to use this:

Your Moonraker is too old and you can't update it
The [simplyprint] component isn't available in your Moonraker version
You've tried the regular setup and it doesn't work

How to use it:

SSH into your printer. The username and password depend on your printer - for Makerbase printers it's mks / makerbase, but for other printers you'll need to check your manufacturer's documentation or community forums for SSH credentials.
If you get SSL errors, fix the date: sudo date -s 'YYYY-MM-DD'
Download the script: wget -O moonraker-sp.sh https://download.simplyprint.io/klipper/moonraker-sp.sh && chmod +x moonraker-sp.sh
Run it: ./moonraker-sp.sh --install
Wait for the installation to complete (the "Installing moonraker dependencies..." step can take up to 10 minutes on slower boards)
The script will display your setup code when done

We can't provide SSH credentials for every printer model. If you don't know how to SSH into your specific printer, try searching for "[your printer model] SSH access" online - many printer communities have documented this.

Printer goes offline after setup

If your Klipper printer was working with SimplyPrint but has gone offline, see Why is my Klipper-powered printer offline?.

Webcam not working

If your printer is connected but the webcam doesn't show up, see Webcam not detected for Klipper-based printer.

Still having trouble? Open up the chat and we'll help you!

Updated on: 09/04/2026

Was this article helpful?

Thank you!