Rat Rig Community [Unofficial]RRC[
Rat Rig Community [Unofficial]•2w ago
HotNozzle

RatOS update sequence for v2.1.0-RC3

I've been struggling to update to RC3. So I am sharing the sequence that worked for me.

Follow the order below in Update Manager or use the code snippets and ssh into the pi and run them manually. I had to run the Final Fix at the end with pnpm install and ratos doctor as the final hurdle.

RatOS Master Update Checklist

  1. Preparation

  • Backup your printer.cfg and any custom macros.
  • Ensure you’re using a reliable SD card (SanDisk Ultra U1 A1 recommended).
  • Stop any ongoing prints before starting.
## 2. Update Sequence

RatOS (OS image/firmware)

  • Flash or update to the latest RatOS release.
  • Reboot and confirm RatOS boots cleanly.

    System (packages and dependencies)

    • Updates Python, libraries, and OS packages.
      sudo apt update && sudo apt upgrade -y

      Klipper

      cd ~/klipper
git pull
./scripts/install-octopi.sh
sudo systemctl restart klipper

      Moonraker

      cd ~/moonraker
git pull
./scripts/install-moonraker.sh
sudo systemctl restart moonraker

      Mainsail

      cd ~/mainsail
git pull

      Crowsnest (camera streaming)

      cd ~/crowsnest
git pull
sudo systemctl restart crowsnest

      RatOSTheme (UI styling)

      cd ~/RatOSTheme
git pull

      Beacon Surface Scanner (if installed)

    • Update Beacon firmware if available.
    • Update Klipper integration:
      cd ~/beacon
git pull
sudo systemctl restart klipper

      RatOS-Configurator

      cd ~/ratos-configurator
git pull
## 3. Final Fix (your discovery)
After completing all updates, run:
ssh pi@ratos.local
cd ~/ratos-configurator/app
pnpm install
ratos doctor

  • pnpm install ensures Node.js dependencies are correct.
  • ratos doctor repairs symlinks, checks configs, and resolves lingering errors.
## 4. Verification
  • Reboot the Pi.
  • Check services:
    systemctl status klipper
systemctl status moonraker
systemctl status crowsnest
  • Open Mainsail in your browser.
  • Run a quick bed mesh with Beacon (if installed).
  • Test a small print to confirm stability.
RC3_Updates.png
Was this page helpful?