Installing Mainsail
The recommended way to install Mainsail on a Raspberry Pi is to use MainsailOS, a pre-packaged disk image. If you are building a custom configuration, you may need to skip these instructions and install Mainsail manually.
MainsailOS
To install Mainsail on a Raspberry Pi:
- Download and install pi-imager
- Click “Choose OS” and scroll down to “Other specific-purpose OS”.
- Select “3D Printing” and choose “Mainsail OS”.
- Choose your SD Card.
- If you will be using Wi-Fi, click on the GEAR icon in the bottom right corner and enter your Wi-Fi information.
-
Click on “SAVE” and on “WRITE”. THIS WILL DESTROY ALL DATA ON YOUR CARD.
note: It is a good idea to use a premium microSD card from a reputable manufacturer such as Sandisk, Kingston or Samsung. Low end cards will often fail quickly when used in this application
- Make sure that your MCU(s) is connected to your pi. If you will be using wired networking, also make sure your ethernet cable is connected.
- Insert the microSD card into your Pi, and power on the Pi.
- Find your Pi on the network, and ssh into it (using PuTTY on Windows or the terminal on MacOS)
The default username ispi
and the password israspberry
.- If your network supports bonjour, the pi should show up as
mainsailos.local
- If your network automatically assigns DNS hostnames, it may simply show up as
mainsailos
- Failing these two options, you may need to check your router’s DHCP server, and find out what IP address as been assigned to the device.
- If your network supports bonjour, the pi should show up as
LCD User Interface
The MainsailOS does not include KlipperScreen which is needed for the LCD interface. This can be installed using Kiauh by following instructions here: Klipper Screen Install.
Software Update
As soon as you have MainsailOS loaded, it is highly recommended that you make sure all the software is up to date. (At times, the downloaded image file contains fairly out of date software.)
- Access Mainsail through a web browser, using whatever IP or hostname you found above.
(Note, you will see some errors regarding the non-configured state of your printer. These can be ignored… for now) - Click the “Machine” button on the left side of the screen
- In the “Update Manager” panel, click the refresh button
- Click the “Update” button for each component that needs updating.
Next: Firmware Flashing
Mainsail Manual Installation
The Mainsail manual installation process is documented in the Mainsail docs.