A Raspberry Pi OS based distribution for 3d Printers. It includes everything to get started with Klipper Firmware and Mainsail.
Learn More about...
Klipper Firmware: https://www.klipper3d.org/
Moonraker: https://moonraker.readthedocs.io/en/latest/
Mainsail: https://docs.mainsail.xyz/
See the installation instructions on the Mainsail documentation page:
https://docs.mainsail.xyz/setup/mainsail-os
For additional help, join us in the Mainsail Discord.
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)
- qemu-arm-static
- Bash
- Git
- Docker
- Docker-Compose
- QEMU for emulation
- About 5GB of free diskspace for the build
** 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 curlgit clone https://github.com/mainsail-crew/MainsailOS.git
cd MainsailOS/
makemake clean - Clean all previous build items except the source raspian image
make distclean - Clean up the source image and trigger a new download
make cleanfix - If your build fails you, sometimes, have no Permission to clean. This will chmod to 0777 to grant full access.MainsailOS/emulation - Contains dependencies for emulation testing
MainsailOS/src/image - Will contain an Raspberry Pi OS Image and according sha1 checksum file
MainsailOS/src/workspace - Created during build, and output for compiled Images
We want to give a shoutout to jottr for mentioning a naming convention problem.
In the past we used 'raspbian' at some points for names.
But this isn't technicaly true.
MainsailOS is based of Raspberry Pi OS, not raspbian.