RatOS update sequence for v2.1.0-RC3

✅Solved

setup

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

sudo apt update && sudo apt upgrade -y

Klipper

cd ~/klipper
git pull
./scripts/install-octopi.sh
sudo systemctl restart 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

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

Mainsail

cd ~/mainsail
git pull

cd ~/mainsail
git pull

Crowsnest (camera streaming)

cd ~/crowsnest
git pull
sudo systemctl restart crowsnest

cd ~/crowsnest
git pull
sudo systemctl restart crowsnest

RatOSTheme (UI styling)

cd ~/RatOSTheme
git pull

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

cd ~/beacon
git pull
sudo systemctl restart klipper

RatOS-Configurator

cd ~/ratos-configurator
git pull

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

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

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.

RRC[

Rat Rig Community [Unofficial]•3mo ago

HotNozzle

RatOS update sequence for v2.1.0-RC3

✅Solved

setup

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

sudo apt update && sudo apt upgrade -y

Klipper

cd ~/klipper
git pull
./scripts/install-octopi.sh
sudo systemctl restart 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

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

Mainsail

cd ~/mainsail
git pull

cd ~/mainsail
git pull

Crowsnest (camera streaming)

cd ~/crowsnest
git pull
sudo systemctl restart crowsnest

cd ~/crowsnest
git pull
sudo systemctl restart crowsnest

RatOSTheme (UI styling)

cd ~/RatOSTheme
git pull

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

cd ~/beacon
git pull
sudo systemctl restart klipper

RatOS-Configurator

cd ~/ratos-configurator
git pull

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

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

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.

RatOS update sequence for v2.1.0-RC3

RatOS Master Update Checklist

1. Preparation

2. Update Sequence

RatOS (OS image/firmware)

System (packages and dependencies)

Klipper

Moonraker

Mainsail

Crowsnest (camera streaming)

RatOSTheme (UI styling)

Beacon Surface Scanner (if installed)

RatOS-Configurator

3. Final Fix (your discovery)

4. Verification

RatOS update sequence for v2.1.0-RC3

RatOS Master Update Checklist

1. Preparation

2. Update Sequence

RatOS (OS image/firmware)

System (packages and dependencies)

Klipper

Moonraker

Mainsail

Crowsnest (camera streaming)

RatOSTheme (UI styling)

Beacon Surface Scanner (if installed)

RatOS-Configurator

3. Final Fix (your discovery)

4. Verification

Similar Threads

Similar Threads

Similar Threads