RatOS Explained: The Firmware Behind Every V-Core

RatOS Explained: The Firmware Behind Every V-Core

What RatOS is, why it powers every V-Core out of the box, the standout features worth knowing, and what changed in the latest 2.1.1 update.
RatOS 2.1: Smarter First Layers, Explained Reading RatOS Explained: The Firmware Behind Every V-Core 4 minutes Next RatOS 2.1: Smarter First Layers, Explained

Every V-Core leaves our workshop running the same firmware: RatOS. If you've only ever used it to slice and print, it's worth knowing what's actually running under the hood, and what's changed recently.

RatOS is a free, open source operating system built around Klipper, developed independently by Mikkel Schmidt with contributions from an active community. It bundles Klipper, Moonraker, Mainsail and KlipperScreen into one point and click package, so you get all the performance of Klipper without needing to hand edit config files or touch a command line.

21,321+ downloads · 6,271+ Discord members · 10+ supported printers · 38+ supported boards

If you want the short version of what's new in the current release first, we cover it in RatOS 2.1: Smarter First Layers, Explained, with the full walkthrough on Rat Rig TV.

What RatOS actually does

Instead of writing and maintaining your own printer.cfg, RatOS's configurator asks you about your hardware, your control board, your toolhead setup, your drivers, and generates a single managed configuration file for you. Change your hardware later, and RatOS updates that file and shows you exactly what changed before you commit to it.

The RatOS configurator's hardware selection screen, showing hotend, extruder, probe and endstop configuration

It also takes over the parts of Klipper maintenance that used to catch people out:

  • Klipper versions are pinned to known working releases, and your MCUs are flashed automatically, so a routine update doesn't leave you with a broken printer.
  • Sensorless homing, current tuning, and driver presets are applied automatically for recognised hardware.
  • An intelligent setup wizard walks you through wiring and board flashing the first time round.

Features worth knowing about

The Mainsail dashboard, the web interface RatOS uses to control and monitor the printer

Mainsail, the web dashboard RatOS runs on top of.

A few things in RatOS go well beyond basic Klipper configuration:

Realtime Analysis Tool (RAT). Live power spectral density graphs, right in your browser, while the printer is running. It's built for hunting down the source of a mechanical issue: touch different parts of the motion system while RAT is running and watch the resonance change in real time.

Visually Assisted Offset Calibration (VAOC). A guided, visual way to calibrate toolhead offsets with z offset probe support, built with multi toolhead printers in mind.

IDEX and Toolshift. On IDEX machines like the V-Core 4.1 IDEX, RatOS handles synchronous toolhead swapping, intelligent purging, automatic z offset calibration before printing, and multi colour or copy and mirror modes, all through macros that are fully IDEX aware.

Adaptive meshing and smart filament handling. Bed meshing and priming adapt automatically to the print in front of them, and filament sensors (on the toolhead, off the toolhead, or both) handle runout and clog detection, automatic loading, and print resume without any manual intervention.

What's new: RatOS v2.1.1

The most recent update, released in June 2026, is a smaller maintenance release, but it's worth reading if you're running specific boards. It corrects a couple of pin assignments:

  • On the Octopus Pro H723 V1.1 control board, the VAOC LED pin and the Y1 enable and extruder heater pins have been corrected.
  • On the EBB42 Gen 2 toolboard, the filament runout sensor pin has moved.

If you're running a stock Rat Rig V-Core 4.0 or 4.1 with standard hardware, none of this affects you. It only matters if you've built around one of those two specific boards with custom wiring.

Why it's worth paying attention to

RatOS gets regular, genuine improvements, not just version bumps, and it's maintained by someone deeply embedded in the same community that uses it. That's part of why we ship it by default on every V-Core: it turns Klipper's raw performance into something you can set up and tune without needing to become a Klipper expert first.

Your rig, your rules.

More from the blog