lixxbox 94858b9340 new file: docs/_config.yml
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
2020-11-27 23:28:52 +01:00

2.5 KiB
Raw Blame History

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 }