Skip to main content

Klipper Integration

Printago connects to Klipper-powered printers over your local network through Moonraker, the API server that ships with almost every Klipper install. The connection runs through the Printago Fuse LAN client, with no cloud lock-in or extra hardware required.

Printago works with any Klipper printer running Moonraker, including Voron (all models), RatRig V-Core / V-Minion, Sovol SV-series, and custom or kit-built machines. (Creality and Snapmaker Klipper printers have their own Creality and Snapmaker guides.) Before you start, install and activate Printago Fuse on a computer or Docker host on the same network as the printer.

Before You Start​

  1. Make sure Moonraker is running. It's installed by default on Mainsail, Fluidd, and most Klipper images. If you can open the printer's web UI in a browser, Moonraker is running.
  2. Note the printer's IP address or hostname (e.g. 192.168.1.100 or voron.local). Assign a static IP or DHCP reservation so it doesn't change.
  3. Check authorization (optional). Stock Klipper installs leave Moonraker unauthenticated, so no API key is needed. If you've added an [authorization] block to moonraker.conf, grab an API key from Moonraker's web UI under Settings → API.

Connect Through Fuse​

  1. In Fuse, open the Printers page and click Add a printer.
  2. Choose Klipper (or pick your specific model).
  3. Fill in the connection details:
    • Printer Name — a friendly name (e.g. "Voron 2.4")
    • Host / IP Address — the printer's IP or hostname (e.g. 192.168.1.100 or klipper.local)
    • Moonraker Port — 7125 (the default)
    • API Key — leave blank unless your install has [authorization] configured
  4. Click Test Connection to confirm Fuse can reach Moonraker.
  5. Click Add Printer. The printer appears in your Printago fleet within a few seconds.

What You Can Do​

Once connected, your Klipper printer behaves like any other printer in Printago:

  • Slice in the cloud and send jobs straight to the printer
  • Route print jobs across your whole fleet automatically
  • Monitor temperatures, progress, and status remotely
  • Manage it alongside the rest of your fleet, whatever the brand, from one dashboard

Troubleshooting​

If the printer won't connect:

  1. Open the printer's web UI (Mainsail/Fluidd) in a browser to confirm Moonraker is up.
  2. Verify the IP/hostname and that the printer is on the same network as Fuse.
  3. Confirm the Moonraker port (default 7125).
  4. If you've enabled [authorization], make sure the API key is correct.
  5. Use Test Connection in the Add Printer dialog to see the specific error.

Still stuck? Reach us on Discord or at support@printago.io.