Link Search Menu Expand Document


Moonraker is a web server that exposes APIs which lets Mainsail interact with Klipper.


Clone Moonraker into your HOME directory:

cd ~
git clone

Run Moonrakers install script:

cd ~/moonraker/scripts
./ -c /home/pi/klipper_config/moonraker.conf


Please pay attention to the following steps!
Misconfigured trusted_clients are a very common source of failure.

For Moonraker you’ll need to create a separate config file.

nano ~/klipper_config/moonraker.conf

Insert the following part and modify trusted_clients according to arksines description below. Also consider further IP ranges, e.g. when connecting via VPN. To determine your local ip ip a and ifconfig -a are common ways to do so on Linux and ipconfig on Windows.

This is a very basic config
For more options and detailed explanations you should follow arksines instructions.

config_path: ~/klipper_config

enabled: true


[update_manager client mainsail]
type: web
repo: meteyou/mainsail
path: ~/mainsail

🔥 trusted_clients - read carefully 🔥
A list of newline separated ip addresses and/or ip ranges that are trusted. Trusted clients are given full access to the API. Both IPv4 and IPv6 addresses and ranges are supported. Ranges must be expressed in CIDR notation (see for more info).
For example, an entry of will authorize IPs in the range of - Note that when specifying IPv4 ranges the last segment of the ip address must be 0. The default is no clients or ranges are trusted.

Save the file with CTRL+O and close the editor with CTRL+X.

Restart Moonraker

sudo service moonraker restart

Open the following url with your printers IP in your browser


If everything has been set up successfully, a message like this should appear:

{"result": {"hostname": "voron250", "error_detected": false, "version": "v0.8.0-643-g528f9f25", "is_ready": true, "message": "Printer is ready", "cpu": "4 core ARMv7 Processor rev 4 (v7l)"}}

< previous step next step >