Skip to main content
Version: 2.1.x

Troubleshooting

My steppers are running backwards!​

Refer to the stepper section at the top of printer.cfg, you can add or remove ! in front of the dir_pin to reverse the direction of that particular stepper.

Everytime i update my changes are gone.​

You're not supposed to change RatOS.cfg or any files inside the managed RatOS config folder. All your configuration changes should be made in printer.cfg or by including custom cfg files, if you need to change settings refer to the Inlcudes & Overrides Documentation section.

Klipper says the MCU is unable to connect​

Double check your USB connection, try another cable (the one that comes with the board usually works), and check that your firmware is flashed correctly using the RatOS configurator wizard at http://RatOS.local/configure/wizard.

I updated klipper and now i get an error!​

Check that your firmware is flashed correctly using the RatOS configurator wizard at http://RatOS.local/configure/wizard.

If you're still having issues, run the RatOS CLI doctor command to ensure your system is in a working state:

ssh pi@RatOS.local
ratos doctor

Section 'gcode_shell_command generate_shaper_graph_x' (or others) is not a valid config section​

This happens if you hard reset klipper through mainsail, your setup can be recovered using the RatOS CLI doctor command:

ssh pi@RatOS.local
ratos doctor

After this command has completed, your system should be back in a working state.

Connection to moonraker failed​

If you see the mainsail interface but you get an error about the connecting to moonraker, the connection to the pi is fine, but you're using a non standard IPv4 or IPv6 range that is not whitelisted in moonraker (only standard local ip ranges are whitelisted for security reasons). Try using the ip address of your pi (look it up in your routers admin interface) instead of ratos.local, or fix it by adding your IP range in CIDR notation to the [authorization] section in ~/klipper_config/moonraker.conf on the pi. You can do that through SSH, by running:

ssh ratos.local
nano ~/klipper_config/moonraker.conf
sudo systemctl restart moonraker

Alternatively you can delete the entire [authorization] section, which will allow anyone to connect to moonraker (which is a security risk).

Get help​

For further support check out the RatOS-support and klipper channels on Discord. Use the invite link below to join.

Join the Unnofficial RatRig Discord Community