Insert the flashed SD card into your Pi and connect any other hardware such a network cable, USB cable to the 3D printer, or a webcam.
Power on the Pi and let it boot up.
The initial boot of MainsailOS may take some time to expand your “root” file system. The larger the SD card, the longer the first boot will take.
Initially the green LED on the Pi will be extremely active. After some time it will only intermittently flicker, indicating it has likely completed the boot sequence.
The web interface should now be ready to access on your local network:
http://<IP address of your Pi>
mainsail.cfg in your printer.cfg file
Mainsail will not work correctly until
mainsail.cfg is included in Klipper’s configuration file. Open Klipper’s default
printer.cfg file in Mainsail’s file manager located in
Settings > Machine. If you do not have a
printer.cfg file, you can create one. Add the following line to
and click on the
Save & Restart button.
Once you’ve successfully navigated to the Mainsail’s web interface it is strongly recommend that you run any available updates.
Klipper, Moonraker and Mainsail have fast development cycles and while we do our best to ensure MainsailOS ships as close to upstream as we can, there will always be a short delay before releases make it into MainsailOS’ image.
It is recommended that you enable and use the built in update-manager to perform any system updates, then update Klipper, Moonraker, Mainsail as needed.
MainsailOS is now configured, and Klipper’s configuration file, [printer.cfg], can be setup.