Skip to content
Wiki
Main site

Firmware restart

A firmware restart reloads the Klipper firmware and all configuration files without rebooting the Raspberry Pi. It is faster than a full reboot (~10–15 seconds vs. ~60 seconds) and is the correct action after most configuration changes.

When to use it

Section titled “When to use it”
  • After editing any file in ~/printer_data/config/ (e.g., printer.cfg)
  • After a SAVE_CONFIG, which writes calibration results and restarts on its own
  • When Klipper shows “Klippy not connected” but the Raspberry Pi is still running
  • When a control board has dropped off and needs the link re-established

When NOT to use it (use full reboot instead)

Section titled “When NOT to use it (use full reboot instead)”
  • After a G1OS (system) update — use Host Control → Reboot
  • If the display or network is unresponsive
  • After updating Moonraker or Mainsail

How to do it — from G1OS (Mainsail)

Section titled “How to do it — from G1OS (Mainsail)”
  1. Open http://g1os.local in a browser
  2. Click the power icon in the top-right corner of the dashboard
  3. In the dropdown menu, select Firmware restart
  4. Klipper restarts — the dashboard briefly shows “Klippy not connected” then reconnects automatically within 10–15 seconds

How to do it — from the Klipper console

Section titled “How to do it — from the Klipper console”

In Mainsail, open the Console tab and type:

FIRMWARE_RESTART

Press Enter. Same effect as the dashboard button.

How to do it — from the display (KlipperScreen)

Section titled “How to do it — from the display (KlipperScreen)”

On the touchscreen display:

  1. Tap the Settings (gear) icon
  2. Tap Restart → Firmware restart

What it does

Section titled “What it does”
  • Reloads printer.cfg and all included config files
  • Re-initializes all stepper drivers and heaters
  • Clears any Klipper error state (including “Emergency stop” triggered by software)
  • Does not reboot the Raspberry Pi or reset the network
  • Does not clear uploaded G-code files

After a firmware restart

Section titled “After a firmware restart”
  • Home the printer before printing — the position is lost on restart
  • Any config change you made is now active
  • If Klipper fails to connect after restart, check the console for config errors
Section titled “Related notes”