> ## 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). # Setting up a Klipper printer with outdated Moonraker via SSH script (2026) Setting up a Klipper printer with outdated Moonraker via SSH script (2026) This guide is for **any Klipper-powered 3D printer** where the regular setup doesn't work because Moonraker is outdated, modified by the manufacturer, or missing the `[simplyprint]` component. It uses a simple SSH script to install a fresh Moonraker instance with SimplyPrint support - your existing Klipper configuration is not affected. || If you can access Mainsail or Fluidd on your printer and the [regular Klipper setup](https://simplyprint.io/setup-guide/methods/klipper-powered) works - use that instead! This guide is for when the regular method doesn't work. ||| **Use at your own risk.** This script has been tested on many printers and installs a separate Moonraker instance alongside your existing setup - it does not modify your Klipper configuration or firmware. However, any modification to your printer's software carries some risk. We cannot guarantee compatibility with every printer or configuration, and we are not responsible for any issues that may arise. If something goes wrong, you can typically remove the installed files and restart your printer to revert to its original state. ## When do you need this guide? - Your printer's Moonraker is **older than v0.8.0** and can't be updated through the web interface - Adding `[simplyprint]` to moonraker.conf **gives an error or isn't recognized** - Your printer ships with a manufacturer-modified Moonraker that removed SimplyPrint support ## Known affected printers These printers are **known** to have this issue, but they're not the only ones - any Klipper printer with SSH access can use this guide: - **Elegoo** - Neptune 4, Neptune 4 Pro, Neptune 4 Plus, Neptune 4 Max - **Qidi Tech** - X-Smart 3, X-Plus 3, X-Max 3, Q1 Pro, Plus4 - **Comgrow** - T300 These all use **Makerbase (MKS) mainboards** with default SSH credentials `mks` / `makerbase`. Other printers may have different SSH credentials - check your manufacturer's documentation or community forums. ## What you'll need 1. Your printer connected to your network (WiFi or Ethernet) 2. Your printer's IP address (usually shown on the printer's screen or in network settings) 3. A computer on the same network The script requires **bash**, **git**, and **Python 3.7+** on the printer. These are pre-installed on virtually all Klipper printers, so you shouldn't need to install anything extra. ## Step 1: Connect via SSH SSH lets you run commands on your printer's built-in computer. Don't worry - you'll just be copying and pasting a few commands. **Open a terminal on your computer:** - **Windows:** Press `Win` + `X` and select "Terminal" or "PowerShell" - **macOS:** Press `Cmd` + `Space`, search for "Terminal", and press Enter - **Linux:** Press `Ctrl` + `Alt` + `T` **Connect to your printer:** `ssh mks@YOUR_IP_ADDRESS` Replace `YOUR_IP_ADDRESS` with your printer's IP, e.g. `ssh mks@192.168.1.42` When prompted for a password, type `makerbase` and press Enter. The password won't show as you type - that's normal. ## Step 2: Fix the date (if you get SSL errors) ||| Most Makerbase-powered printers - especially Qidi Tech models - have the system clock set wrong. This causes SSL errors like `ERROR: The certificate of 'download.simplyprint.io' is not trusted`. If you see this error, fix the date first: `sudo date -s 'YYYY-MM-DD'` **Replace `YYYY-MM-DD` with today's date**, e.g. `sudo date -s '2026-04-09'`. You may be prompted for a password - use `makerbase`. ## Step 3: Download and run the installer Copy and paste this **entire line** into your terminal to download the script: > wget -O moonraker-sp.sh https://download.simplyprint.io/klipper/moonraker-sp.sh && chmod +x moonraker-sp.sh Then run the installer: > ./moonraker-sp.sh --install You may be prompted for a password - use `makerbase`. | **Be patient!** When the script says "Installing moonraker dependencies..." it can take **up to 10 minutes**. The printer's board is not very powerful and it's upgrading Python packages in the background. Don't cancel or restart - just let it finish. ## Step 4: Get your setup code Once the script finishes, it will display your printer's **setup code**. Use this code to add your printer in the [SimplyPrint panel](https://simplyprint.io/panel/printers?add_printer). Your printer may also show up automatically under **Pending Printers**. That's it! Your printer is now running a fresh Moonraker instance with SimplyPrint enabled. ## What does this script do? The `moonraker-sp.sh` script installs a separate, up-to-date Moonraker instance with the SimplyPrint component alongside your existing printer setup. Your existing Klipper configuration and web interface (Mainsail/Fluidd) are not modified. The new Moonraker instance only handles the SimplyPrint connection. ## Troubleshooting - **"Connection refused" when SSH-ing** - Make sure you're on the same network and the IP address is correct - **"Permission denied"** - Double-check username (`mks`) and password (`makerbase`) - **SSL errors during installation** - Fix the system date (see Step 2) - **Script seems stuck** - The dependency installation step can take up to 10 minutes. Wait it out. - **Setup code doesn't appear** - Try running the script again. If it still doesn't work, check that your printer has internet access. ## About the old OctoPrint method We previously had a guide that installed OctoPrint via KIAUH on Makerbase printers. That method **no longer works** on most affected printers because KIAUH now requires a newer Python version than these older boards support. The old guide is still available [here](https://help.simplyprint.io/en/article/setting-up-a-makerbase-powered-3d-printer-in-simplyprint-12f6wfc/) for reference, but we don't recommend following it. You can also follow this guide directly on our website: - [Elegoo Neptune 4 setup](https://simplyprint.io/setup-guide/elegoo/neptune-4) - [Qidi Tech setup](https://simplyprint.io/setup-guide/qidi-tech/makerbase) - [Comgrow T300 setup](https://simplyprint.io/setup-guide/comgrow/t300) - [General guide for any Klipper printer](https://simplyprint.io/setup-guide/methods/makerbase-powered)