KlipperFleet

Warning

ALPHA SOFTWARE - Tested on specific CAN bus, STM32 Serial/DFU, and Linux Process devices (see below). Non-Raspberry Pi and Fluidd are unsupported but on the roadmap. Kalico is auto-detected if installed at ~/klipper.

Contributions and bug reports are appreciated!

KlipperFleet is a web interface (integrated into Mainsail) for configuring, building, and flashing Klipper/Kalico firmware across all MCUs on a printer. No command line needed.

One click builds and flashes every MCU on the printer - CAN nodes, CAN bridge, and host - in the right order, with live logs.

Features

• Web Configurator: Replaces make menuconfig with a reactive web form parsed from Klipper's Kconfig source.
• Fleet Management: Register MCUs (Serial, CAN, DFU), assign profiles, and attach DFU IDs to Serial devices for cross-reboot tracking.
• Smart Sequencing: Flashes CAN downstream nodes first, bridge hosts last.
• UART Support: Detects MCUs connected via Raspberry Pi UART (GPIO).
• Batch Operations: Build All, Flash Ready, Flash All, or Build & Flash All in one click.
• Auto Reboot: Detects Klipper vs. Katapult/DFU mode and reboots devices into the correct bootloader automatically.
• Service Management: Stops/starts Klipper and Moonraker services during flash operations.
• Integrated Flashing: Flash via Serial, CAN, or DFU from the browser with real-time log streaming.
• Backup & Restore: Export your fleet registry and profiles as a ZIP, or import a previous backup to restore after a fresh install.
• Mainsail Integration: Native look and feel within the Mainsail ecosystem.

Tested Hardware

Important

All other hardware should be considered untested. Please open an issue if you run into problems, or share your results in the compatibility thread.

Screenshots

Expand screenshots

Dashboard	Configurator
Fleet Manager	Backup & Restore

Prerequisites

• Klipper at ~/klipper and Katapult at ~/katapult
• can-utils (CAN devices only), Python 3.9+ with venv
• Passwordless sudo for systemctl and ip link

Installation

Run this one-liner on your Raspberry Pi:

wget -qO - https://raw.githubusercontent.com/JohnBaumb/KlipperFleet/main/install.sh | sudo bash

cd ~
git clone https://github.com/JohnBaumb/KlipperFleet.git
cd KlipperFleet
sudo chmod +x install.sh
sudo ./install.sh

Moonraker Integration

Add the following to moonraker.conf:

[update_manager klipperfleet]
type: git_repo
path: ~/KlipperFleet
origin: https://github.com/JohnBaumb/KlipperFleet.git
primary_branch: main
managed_services: klipperfleet
virtualenv: ~/KlipperFleet/venv
requirements: backend/requirements.txt
system_dependencies: install_scripts/system-dependencies.json
is_system_service: False

The installer auto-configures the Mainsail sidebar tab via .theme/navi.json.

[
  {
    "title": "KlipperFleet",
    "href": "/klipperfleet.html",
    "target": "_self",
    "icon": "M20,21V19L17,16H13V13H16V11H13V8H16V6H13V3H11V6H8V8H11V11H8V13H11V16H7L4,19V21H20Z",
    "position": 86
  }
]

Usage

1. Configurator - Select a profile, configure MCU settings, click Save.
2. Fleet Manager - Scan for devices, add them to your fleet, assign profiles. Use Attach to link DFU IDs to Serial devices for cross-reboot tracking.
3. Dashboard - Build All compiles firmware, Flash Ready flashes everything already in a flashable state (bootloader-ready, DFU, or direct-flash) without rebooting running devices, Flash All reboots and flashes everything, Build & Flash All does it all in one click.

Note

Use Backup & Restore (sidebar) to export your fleet registry and profiles as a ZIP, or import one after a fresh install. CAN UUIDs and stable serial paths carry over automatically; if you change USB ports, update the serial paths in the Fleet Manager. Rebuild firmware from the Dashboard afterward to regenerate artifacts.

Technical Details

Roadmap

• Enhanced DFU handling and bridge recovery
• Per Device Profile Import/Export
• User wiki with setup guides and troubleshooting
• Fluidd sidebar integration (already works by adding the Moonraker update manager entry)

License

GPLv3