Link Search Menu Expand Document

First boot

Insert the flashed SD card into your Pi and connect other desired/necessary hardware (ethernet, USB to 3D printer, webcam).

Power on the Pi and leave it to boot.

The initial boot of MainsailOS may take some time to expand your “root” filesystem. 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 ui should now be ready to access on your local network:

http://<IP address of your pi>


Important: Include the mainsail.cfg into your printer.cfg

Mainsail will not work unless Klipper is told to include its configuration. This can be achieved either by placing the contents of mainsail.cfg into your printer.cfg.

To do this, open the default printer.cfg in the Mainsail web GUI:



Add the following line:

[include mainsail.cfg]

and click on the “Save & Restart” button.


Once you’ve successfully navigated to the Mainsail web ui we thoroughly recommend that you run updates.

Klipper, Moonraker and Mainsail have fast development cycles and whilst we do our best to ensure MainsailOS ships as close to the bleeding edge as we can, there will always be a short delay before releases make it into the image.

We recommend that you enable and use the built in update-manager to perform a system update, then update the stack components (Klipper, Moonraker, Mainsail)


MainsailOS is now configured, and we can get Klipper’s printer.cfg setup.

< tool selection next step >