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:

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

jottr/MainsailOS