RatOS is a preconfigured Raspberry Pi image that aims to make it as painless as possible to get Klipper, Mainsail and Moonraker up and running on your printer. It is developed and maintained by Mikkel Schmidt (miklschmidt#2036 on the Rat Rig Unofficial Discord) with help from the community.

Start by reading the Documentation

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

** 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

git clone https://github.com/Rat-Rig/RatOS.git
cd RatOS/
make build

or without docker:

git clone https://github.com/guysoft/CustomPiOS.git
git clone https://github.com/Rat-OS/RatOS.git
cd RatOS/src/image wget -c --trust-server-names 'https://downloads.raspberrypi.org/raspios_lite_armhf_latest'
cd ..
../../CustomPiOS/src/update-custompios-paths
sudo modprobe loop
sudo bash -x ./build_dist

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

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