Articles on: Get started

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 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

Your printer connected to your network (WiFi or Ethernet)
Your printer's IP address (usually shown on the printer's screen or in network settings)
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. 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 for reference, but we don't recommend following it.

You can also follow this guide directly on our website:

Updated on: 09/04/2026

Was this article helpful?

Thank you!