MainsailOS

Prebuilt Raspberry Pi OS image with Klipper, Moonraker and the Mainsail web interface for 3D printers.

Verified Special Projects

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

ModelStatusNotesSource
Raspberry Pi Zero familyNo data
Raspberry Pi Zero 2 WSupported64-bit image (Raspberry Pi Imager device classes pi3/pi4/pi5)Official download page
Raspberry Pi 1Supported32-bit image (Raspberry Pi Imager device classes pi1/pi2)Official download page
Raspberry Pi 2 Model BSupported32-bit image (Raspberry Pi Imager device classes pi1/pi2)Official download page
Raspberry Pi 3Supported64-bit image (Raspberry Pi Imager device classes pi3/pi4/pi5)Official download page
Raspberry Pi 4 Model BSupported64-bit image (Raspberry Pi Imager device classes pi3/pi4/pi5)Official download page
Raspberry Pi 5Supported64-bit image (Raspberry Pi Imager device classes pi3/pi4/pi5)Official download page
Raspberry Pi 400Supported64-bit image (Raspberry Pi Imager device classes pi3/pi4/pi5)Official download page
Raspberry Pi 500 familyNo data
Compute ModulesNo 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

VersionReleasedTypeBased onDownload
3.0.0May 6, 2026Major release
2.2.2October 3, 2025Patch release
2.2.0September 7, 2025Minor release
2.1.0August 15, 2025Minor release
2.0.0May 19, 2025Major release

Sources

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