> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://help.simplyprint.io/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # Troubleshooting Klipper/Moonraker setup with SimplyPrint 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](https://help.simplyprint.io/en/article/printer-in-setup-isnt-detected-cant-find-setup-code-3jyftm/). ## 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:** 1. In Mainsail or Fluidd, open the Update Manager / Software Updates section 2. If a Moonraker update is available, click Update 3. 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: 1. **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/` 2. **Make sure the syntax is correct.** It must be exactly `[simplyprint]` on its own line - no extra spaces, no typos. 3. **Restart Moonraker** after saving. In Mainsail, go to Machine > Power > Moonraker restart. In Fluidd, go to Settings > Restart Moonraker. 4. **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](https://simplyprint.io/panel/printers?add_printer) 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](https://help.simplyprint.io/en/article/printer-in-setup-isnt-detected-cant-find-setup-code-3jyftm/). ## 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: - [Elegoo Neptune 4 setup guide](https://simplyprint.io/setup-guide/elegoo/neptune-4) - [Qidi Tech setup guide](https://simplyprint.io/setup-guide/qidi-tech/makerbase) - [Comgrow T300 setup guide](https://simplyprint.io/setup-guide/comgrow/t300) Or see our [detailed Makerbase helpdesk article](https://help.simplyprint.io/en/article/setting-up-a-makerbase-powered-3d-printer-with-simplyprint-jb6p2l/) for step-by-step instructions. Have a different Makerbase-powered printer? Use the [general Makerbase guide](https://simplyprint.io/setup-guide/methods/makerbase-powered). 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:** 1. 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. 2. If you get SSL errors, fix the date: `sudo date -s 'YYYY-MM-DD'` 3. Download the script: `wget -O moonraker-sp.sh https://download.simplyprint.io/klipper/moonraker-sp.sh && chmod +x moonraker-sp.sh` 4. Run it: `./moonraker-sp.sh --install` 5. Wait for the installation to complete (the "Installing moonraker dependencies..." step can take up to 10 minutes on slower boards) 6. 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?](https://help.simplyprint.io/en/article/why-is-my-klipper-powered-printer-offline-r4gwnc/). ## Webcam not working If your printer is connected but the webcam doesn't show up, see [Webcam not detected for Klipper-based printer](https://help.simplyprint.io/en/article/webcam-not-detected-in-simplyprint-for-klipper-based-printer-mainsail-fluidd-moonraker-mewdfx/). --- **Still having trouble?** Open up the chat and we'll help you!