13233ca878
* major docs update * Delete info.md * update file permissions * added screenshots and updated first-boot.md
2.4 KiB
layout, title, parent, grand_parent, nav_order, has_children, permalink
| layout | title | parent | grand_parent | nav_order | has_children | permalink |
|---|---|---|---|---|---|---|
| default | First boot | MainsailOS | Setup Guides | 3 | false | /setup/mainsailos/first-boot |
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. {: .warning}
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.
Mainsail.cfg
Important: Include the mainsail.cfg into your printer.cfg {: .warning}
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 fi>
To do this, open the default printer.cfg in the Mainsail web GUI:
Add the following line:
[include mainsail.cfg]
Save the file (ctrl+s) and exit nano (ctrl+x).
Reboot the Pi, or restart the klipper service for it to take affect.
sudo reboot
or
sudo systemctl restart klipper
The web ui should now be ready to access on your local network:
http://mainsailos.local
http://<IP address of your pi>
Updates
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{: .btn } next step >{: .btn }