MainsailOS
Prebuilt Raspberry Pi OS image with Klipper, Moonraker and the Mainsail web interface for 3D printers.
About MainsailOS
MainsailOS is a prebuilt image that already includes Mainsail, Moonraker and Klipper, the software needed to run Klipper 3D printer firmware with Mainsail as the web interface. It also includes the Crowsnest webcam daemon, the Sonar Wi-Fi keepalive daemon, the Moonraker timelapse plugin and the dependencies for measuring resonances.
The Raspberry Pi images are based on Raspberry Pi OS: a 64-bit image for the Pi 3, 4 and 5 and a 32-bit image for the Pi 1 and 2. MainsailOS also provides images for several Orange Pi boards, which are not listed here.
Raspberry Pi compatibility for version 3.0.0
| Model | Status | Notes | Source |
|---|---|---|---|
| Raspberry Pi Zero family | No data | ||
| Raspberry Pi Zero 2 W | Supported | 64-bit image (Raspberry Pi Imager device classes pi3/pi4/pi5) | Official download page |
| Raspberry Pi 1 | Supported | 32-bit image (Raspberry Pi Imager device classes pi1/pi2) | Official download page |
| Raspberry Pi 2 Model B | Supported | 32-bit image (Raspberry Pi Imager device classes pi1/pi2) | Official download page |
| Raspberry Pi 3 | Supported | 64-bit image (Raspberry Pi Imager device classes pi3/pi4/pi5) | Official download page |
| Raspberry Pi 4 Model B | Supported | 64-bit image (Raspberry Pi Imager device classes pi3/pi4/pi5) | Official download page |
| Raspberry Pi 5 | Supported | 64-bit image (Raspberry Pi Imager device classes pi3/pi4/pi5) | Official download page |
| Raspberry Pi 400 | Supported | 64-bit image (Raspberry Pi Imager device classes pi3/pi4/pi5) | Official download page |
| Raspberry Pi 500 family | No data | ||
| Compute Modules | No data |
“No data” means we have no verified information – not that it does not work. Compatibility is taken from official or documented sources only.
Installation
MainsailOS is available in Raspberry Pi Imager under Other specific-purpose OS → 3D printing → Mainsail OS. Alternatively download the image from the GitHub release and write it to a microSD card.
Releases
Sources
- MainsailOS documentation (retrieved November 20, 2026)
- MainsailOS 3.0.0 release (images and rpi-imager.json) (retrieved November 20, 2026)
- Category
- Special Projects
- Image type
- Appliance image
- Architecture
- ARM32 – ARMv7 (armhf), ARM64 (AArch64)
- License
- GPL-3.0-only
- Project status
- Active
- Verification
- Verified from trusted source
- Last updated
- May 6, 2026
- Last checked
- November 22, 2026
- Listed since
- November 21, 2026