MainsailOS

A Raspberry Pi distribution for 3d Printers. It includes everything to get started with Klipper Fimware and Mainsail.

Learn More about...
Klipper Firmware: https://www.klipper3d.org/
Moonraker: https://moonraker.readthedocs.io/en/latest/
Mainsail: https://docs.mainsail.xyz/

Installing

See the installation instructions on the Mainsail documentation page:
https://docs.mainsail.xyz/setup/mainsail-os

Community

For additional help, join us in the Mainsail Discord.

What is included?

Here a list of included and preinstalled Software:

• Klipper (3D Printer Firmware)
• Moonraker (API Web Server for Klipper)
• Mainsail (Web interface for Klipper/Moonraker)
• Mjpeg-streamer (Webcam streaming)
• Nginx (Webserver & Proxy)
• FFMPEG (upcoming features)

Screenshots

Build your own / Developing

Requirements

• qemu-arm-static
• CustomPiOS
• Downloaded Raspbian Image
• Bash
• Git
• Docker
• Docker-Compose
• QEMU for emulation
• About 5GB of free diskspace for the build

Packages for Ubuntu 18.04/20.04

** Dekstop variants are known to cause issues during build due to snaps takeing up loop mounts **

sudo apt-get install gawk make build-essential util-linux \
qemu-user-static qemu-system-arm \
git p7zip-full python3 curl

Compiling source

git clone https://github.com/raymondh2/MainsailOS.git
cd MainsailOS/
make build

Other make options

make clean - Clean all previous build items except the source raspian image
make distclean - Clean up the source image and trigger a new download

Build layout

MainsailOS/emulation - Contains dependencies for emulation testing
MainsailOS/src/image - Contains our base raspbian image
MainsailOS/src/workspace - Created during build, and output for compiled images