Skip to main content Link Menu Expand (external link) Document Search Copy Copied

First boot

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>


Important: Include 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 printer.cfg

[include mainsail.cfg]



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.

< tool selection next step >