Klipper / Moonraker
Bridge connects to any Klipper-based printer through the Moonraker API server. This works with any Klipper setup that has Moonraker installed, including:
- Mainsail OS
- Fluidd
- MainsailOS on a Raspberry Pi
- Custom Klipper installations with Moonraker
What You Need
| Field | Where to Find It |
|---|---|
| IP Address | The IP of your Klipper host (Raspberry Pi, etc.). Check your router or try http://mainsail.local. |
No API keys or access codes needed — Moonraker's API is open by default on your local network.
Setup Steps
- Make sure Moonraker is running on your Klipper host
- In Bridge, click Add Printer
- Set Platform to
Klipper / Moonraker - Enter the IP Address
- (Optional) Set Port if Moonraker isn't on the default 7125
- (Optional) Enable SSL if you've configured HTTPS
- Click Save
Remote Printing
You can upload and start prints on Klipper printers directly from the PrintHQ dashboard. Bridge uploads the gcode file via Moonraker's file upload API and starts the print.
Object Exclusion
During an active print, you can skip individual objects without canceling the entire job. This requires the EXCLUDE_OBJECT macro to be configured in your Klipper setup. Bridge sends exclude commands via Moonraker's gcode API.
Camera Streaming
Klipper setups don't have a default camera URL, but if you have a webcam configured (via crowsnest, mjpg-streamer, etc.), you can add the camera URL in the Bridge printer settings. Bridge will relay the MJPEG or snapshot stream to the dashboard.
Connection Details
| Setting | Value |
|---|---|
| Protocol | WebSocket JSON-RPC + REST API |
| Default Port | 7125 |
| Authentication | None (local network) |
| WebSocket | ws://<ip>:7125/websocket |
What Bridge Reports
- Nozzle and bed temperatures (current and target)
- Print state (printing, paused, standby, error, complete)
- Current file name and print progress
- Layer information
- Fan speeds
- Print speed
Also Works With
Any printer firmware that exposes a Moonraker-compatible API on your network will work with this adapter. This includes:
- Anycubic Kobra 3 / V2 with Rinkhals installed (see Anycubic guide)
- Creality K1 series (also has a native Creality adapter — see Creality guide)
- Any custom Klipper build with Moonraker
Troubleshooting
- Can't connect? Make sure Moonraker is running:
sudo systemctl status moonraker - Port 7125 refused? Check if Moonraker is configured to listen on a different port in
moonraker.conf - CORS errors? If Bridge is running on a different machine, make sure Moonraker's
cors_domainsincludes the Bridge host