new file: docs/_sass/color_schemes/mainsail-dark.scss new file: docs/_sass/color_schemes/mainsail.scss new file: docs/about.md new file: docs/additional-support/index.md new file: docs/additional-support/shares.md.draft new file: docs/additional-support/slicer-upload.md new file: docs/additional-support/thumbnails.md new file: docs/additional-support/webcam.md.draft new file: docs/assets/img/additional/FileUpload-PrusaSlicer-2.2.0.png new file: docs/assets/img/additional/PrusaSlicer-thumbnails.png new file: docs/assets/img/additional/SuperSlicer-thumbnails.png new file: docs/assets/img/additional/large-preview.png new file: docs/assets/img/logo-mainsail-light.png renamed: docs/images/logo-mainsail.png -> docs/assets/img/logo-mainsail.png new file: docs/assets/img/logo.png new file: docs/assets/img/logo.svg new file: docs/assets/img/screenshot.png deleted: docs/images/screenshot-dashboard.png deleted: docs/images/screenshot-gcode-thumbnail.png deleted: docs/images/superslicer-upload.png new file: docs/index.md new file: docs/necessary-cfg.md new file: docs/setup-guide/index.md new file: docs/setup-guide/klipper.md new file: docs/setup-guide/mainsail.md new file: docs/setup-guide/moonraker.md new file: docs/setup-guide/operating-system.md
2.5 KiB
layout | title | parent | nav_order | permalink |
---|---|---|---|---|
default | Moonraker | Setup Guide | 4 | /setup/moonraker |
Moonraker
Moonraker is a web server that exposes APIs which lets Mainsail interact with Klipper.
Installation
Clone Moonraker into your HOME directory:
cd ~
git clone https://github.com/Arksine/moonraker.git
Run Moonrakers install script:
cd ~/moonraker/scripts
./install-moonraker.sh
Once the script is finished, both Moonraker and Klipper should be started.
In /tmp/klippy.log
the following entry should appear: Moonraker: server connection detected
Configuration
⚠️ 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 ~/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.
[server]
host: 0.0.0.0
config_path: ~/klipper_config
[authorization]
enabled: true
trusted_clients:
192.168.1.0/24
🔥 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 http://ip.sb/cidr for more info).
For example, an entry of 192.168.1.0/24 will authorize IPs in the range of 192.168.1.1 - 192.168.1.254. 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
http://<printer-ip>:7125/printer/info
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{: .btn } next step >{: .btn }