LAN Client (Fuse)

Printago Fuse is a lightweight client that runs on your local network, bridging Printago to printers that aren't reachable via cloud connections. Fuse handles the local communication so you get full Printago functionality regardless of how your printer connects.

LAN Connection in the Printago App

In the Printago app, Fuse appears as the LAN Connection option on the Connections page (app.printago.io/connections). It's marked Recommended: full control with real-time status, camera streaming, and support for all printers, requiring a small app running on your network. The other card, Bambu Cloud Connection, needs nothing installed but is limited to X1/P1/A1 models on older firmware.

Click Configure on the LAN Connection card to open the LAN Connections page. From there you can download Fuse for your platform and manage the Fuse clients connected to your account:

• Download Fuse (LAN Client) buttons for Mac (Apple Silicon), Mac (Intel), Windows (64-bit), and Docker (Linux / Self-hosted), along with the latest version number
• Connected Clients listing each Fuse client's ID, IP address, last check-in, and first-connected time, with a Delete button to remove a client from your account

Download

The downloads below are also available in the app on the LAN Connections page.

Desktop Applications

Platform	Download
Windows (10+, 64-bit)	Download
macOS Apple Silicon	Download
macOS Intel	Download

Docker

Docker is a great option for headless servers, Raspberry Pi, or managed deployments.

Quick Start

docker volume create fuse_config
docker volume create fuse_data
docker pull ghcr.io/printago/fuse:latest
docker run -d \
  --name printago-fuse \
  --restart unless-stopped \
  -p 8888:8888 \
  -v fuse_config:/app/config \
  -v fuse_data:/app/data \
  ghcr.io/printago/fuse:latest

Docker Compose

Add this service to your docker-compose.yml. Configuration and print data persist across container restarts and updates.

services:
  fuse:
    image: ghcr.io/printago/fuse:latest
    container_name: printago-fuse
    restart: unless-stopped
    ports:
      - "8888:8888"
    volumes:
      - fuse_config:/app/config
      - fuse_data:/app/data

volumes:
  fuse_config:
  fuse_data:

After starting the container, access Fuse at http://localhost:8888 to complete setup.

Updating Fuse

How you update Fuse depends on how you installed it.

Safe to update during active prints

It's safe to update or restart Fuse while prints are running. Your printers keep printing on their own, and they'll reconnect to Fuse automatically once it's back up. The only thing affected is the brief window while Fuse is offline: live telemetry and printer status changes won't be propagated to Printago during that time, and they'll resume as soon as Fuse reconnects.

Desktop Applications (Windows & macOS)

The Windows and macOS apps update themselves automatically, so there's nothing to download or reinstall.

• Fuse checks for new versions shortly after launch and then periodically while it's running.
• When a newer version is found, it's downloaded quietly in the background.
• Once the download finishes, an Update Available banner appears at the top of the Settings page showing the new version number.
• Click Quit and Install Update to apply it. Fuse will close, install the update, and relaunch. You can also choose Quit and Install Update from the Fuse tray/menu-bar icon.

You can apply the update whenever it's convenient, including while prints are running (see the note above). If you'd rather wait, leave the update pending and it will be installed automatically the next time you quit Fuse.

Docker

Docker containers don't update themselves, but Fuse will tell you when a newer image is available. When an update is published, an Update Available banner appears on the Settings page with the new version number. Expand How to Update for the exact commands.

To pull and apply the latest image:

Using Docker Compose (from the directory containing your docker-compose.yml):

docker compose pull
docker compose up -d

Using Docker Run:

docker pull ghcr.io/printago/fuse:latest
docker stop printago-fuse
docker rm printago-fuse
docker run -d \
  --name printago-fuse \
  --restart unless-stopped \
  -p 8888:8888 \
  -v fuse_config:/app/config \
  -v fuse_data:/app/data \
  ghcr.io/printago/fuse:latest

Your printer configuration and cached print files persist across updates because they live in the fuse_config and fuse_data volumes, so pulling a new image won't lose your setup. The container is briefly stopped and recreated during the update, which is safe to do during active prints (see the note above).

Automatic updates with Watchtower: If you'd like Docker deployments to update on their own, run Watchtower alongside Fuse to check for and apply new images on a schedule:

docker run -d \
  --name watchtower \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower \
  --interval 86400 \
  printago-fuse

This checks for and applies updates to the printago-fuse container once a day.

Prerequisites

Before setting up Fuse, ensure your Bambu Lab printers have:

• LAN Mode enabled
• Developer Mode enabled

These settings can be configured in your printer's settings menu.

Storage required for print uploads

Fuse sends print files to Bambu Lab printers over FTPS, which writes to the printer's storage. On models that use a USB flash drive (X2D, P2S, and the H2 series), a USB drive must be inserted or print jobs will fail to upload. These printers also have a small internal storage cache, but it is not accessible over FTPS, so Fuse cannot use it as a fallback.

Models with a microSD card slot (X1, P1, and A1 series) need their card inserted, which it normally is out of the box.

Network Requirements

Fuse requires the following network ports for printer communication:

Port	Protocol	Purpose
8883	MQTTS	Printer control and status updates
990	FTPS	File transfer (print jobs)
1990, 2021	SSDP	Printer auto-discovery
322, 6000	RTSP	Live camera / video streaming

Activation

When you first launch Fuse, you'll need to connect it to your Printago account.

Activation Process

1. Start Fuse Client: Launch the Fuse application. You'll see an activation screen displaying a unique activation code (e.g., SQMA-VR2N) and an expiration timer.

2. Activate in Printago: You have two options to complete activation:

   Option A: Click the activation link

   • Click the "Open Printago to Activate" button on the Fuse screen
   • This will open your browser to app.printago.io/activate with the code pre-filled

   Option B: Manual entry

   • Navigate to app.printago.io/activate in your browser
   • Enter the activation code displayed in Fuse
   • Click activate

3. Confirmation: Once activated, both the Printago web interface and your Fuse client will display "Activation Successful!" The Fuse interface will automatically update to show the status dashboard.

4. Request New Code: If your activation code expires (codes are valid for 15 minutes), click "Request New Activation Code" to generate a fresh one.

Status Dashboard

After activation, the Fuse Status page displays three key indicators:

• Printers: Shows the count of connected printers (e.g., "8 connected")
• Fuse Client (LAN): Indicates whether the local Fuse service is running
• Printago (Cloud): Shows connection status to the Printago cloud gateway

All three indicators should show positive status (Connected/Running) for full functionality.

Adding Printers

Fuse supports multiple methods to add printers. Navigate to the Printers page using the top navigation menu.

Adding Physical Printers

Method 1: Auto-Scan (Recommended)

The fastest way to discover Bambu Lab printers on your local network using SSDP discovery.

1. Click the Auto-Scan button in the top right
2. Fuse will scan your local network for compatible Bambu Lab printers
3. Discovered printers will be displayed with their IP address, model, and serial number
4. Select the printers you want to add and provide their access codes
5. Click "Add Selected Printers" to complete the setup

Method 2: Subnet Search

If auto-scan doesn't find your printers (e.g., they're on a different subnet), use a custom subnet scan.

1. Click the dropdown arrow next to Auto-Scan
2. Select Scan Custom Subnet
3. Enter your subnet in CIDR notation (e.g., 192.168.0.0/24)
4. Click Scan
5. Fuse will probe each IP address on port 8883 for Bambu Lab printers
6. Follow the same selection process as auto-scan

Common subnet examples:

• 192.168.0.0/24 - Scans 192.168.0.1 through 192.168.0.254
• 192.168.1.0/24 - Scans 192.168.1.1 through 192.168.1.254
• 10.0.1.0/24 - Scans 10.0.1.1 through 10.0.1.254

Method 3: Add Manually

For printers that aren't discovered automatically, or when you prefer manual configuration.

1. Click Add Printer in the top right.
2. In the Add a printer dialog, pick your printer's brand (Bambu Lab, Prusa, Creality, Elegoo, Snapmaker, Anycubic, or Ultimaker), or type your model into the search box (for example "MK4", "K1", "Neptune", or "A1").

3. Select your specific model from the list.
4. In the Configure Printer dialog, fill in the connection details:
   • Name: A friendly name for your printer (e.g., "Workshop X1 Carbon"). This defaults to the model name.
   • IP Address: The local network IP address of your printer (e.g., 192.168.0.30).
   • Access Code: Your printer's access code. See Finding Your Access Code below for where to find it on each brand.
   • Serial Number: Detected automatically once the IP address and access code are valid, so there's no need to enter it by hand.
   • Printago Cloud Status: Confirms whether the printer is recognized by your Printago account once the serial number is detected.
5. Click Add Printer to save the configuration.

Finding Your Access Code

Most networked printers require an access code (also called a LAN access code or password) so Fuse can connect locally. Where you find it depends on the brand:

• Bambu Lab: On the printer's touchscreen, open Settings (gear icon) and go to the network/WLAN screen. The Access Code is listed alongside the IP address. LAN Mode and Developer Mode must be enabled. See the Bambu Lab integration guide for step-by-step instructions per model.
• Creality / Klipper: Use the LAN/Moonraker access details from the printer's screen or web interface. See the Creality guide.
• Elegoo: Use the LAN access code shown in the printer's network settings. See the Elegoo guide.
• Snapmaker: Use the access code from the printer's network settings. See the Snapmaker guide.
• Prusa: Use the connection details from PrusaLink. See the Prusa guide.

Adding Virtual Printers

Virtual printers are simulated printers useful for testing and demonstration purposes. You can create up to 20 virtual printers per Fuse client.

1. Click Add Printer in the top right.
2. In the Add a printer dialog, choose the Virtual Printer tile ("For testing and fun", listed alongside the printer brands).
3. In the Add Virtual Printer form, set the printer name, quantity, printer model, nozzle diameter, and filament slots.
4. Click Add Printer.

Virtual printers appear in your printer list just like physical printers and can be used to test workflows without affecting real equipment. See the Virtual Printers guide for the full walkthrough, including syncing them to Printago and using the simulation controls.

Importing Configuration

To import printer configurations from a backup or another Fuse instance:

1. Click the dropdown arrow next to Add Printer in the top right.
2. Select Import from the menu.

3. Select your configuration file.
4. Review and confirm the imported printers.

The same dropdown also includes Restore, which opens the Configuration Snapshots restore dialog.

Managing Printers

Printer Cards

The Printers page displays all your configured printers as cards showing:

• Header: Printer name, model icon, and connection status indicator
• Status: Current printer state (Idle, Printing, etc.)
• IP Address: Network address of the printer
• Serial Number: Unique device identifier
• Temperatures: Real-time nozzle, bed, and chamber temperatures
• AMS Status: Filament slots with colors and material types
• MQTT Timing: Connection statistics (Connected At, Last Received, Reconnects)

The Stats / Snapshots toggle at the top right of the Configured Printers panel switches what the printer cards display.

Printer Actions

Each printer card includes action buttons:

• Camera: View the printer's live camera feed directly in the card
• Communications: Access MQTT message logs for debugging
• Edit: Modify printer configuration
• Delete: Remove the printer from Fuse

Live Camera View

Click the camera icon on any printer card to view the live camera feed. The video stream is embedded directly in the printer card.

MQTT Communications

The Communications view shows real-time MQTT messages between Fuse and the printer. This is useful for troubleshooting and understanding printer behavior.

Click on any message to see the parsed JSON data with full printer state information including:

• Print stage and progress
• Temperature readings
• Fan speeds
• AMS configuration
• Error states

Virtual Printer Controls

Virtual printers include additional simulation controls, opened from the printer card:

• Connection Status: Toggle the printer online or offline to simulate connectivity
• HMS Error Simulation: Pick an error code (with an optional custom message) and click Trigger Error; Clear All Errors removes simulated errors
• Test Print: Click Start Test Print to download a test file and begin a simulated print job

Editing Printer Settings

Click the edit icon next to any printer to modify its configuration. You can update:

• Printer name
• IP address (if the printer's network address changes)
• Access code

Removing Printers

Click the delete icon to remove a printer from your Fuse configuration. This only removes the printer from Fuse; it doesn't affect the physical printer or any data in Printago.

Configuration Snapshots

Fuse keeps a history of your printer configuration so you can roll back if something goes wrong. Each snapshot captures the full set of configured printers (names, IP addresses, models, access codes, and slot setup) at a point in time.

Automatic Snapshots

Fuse saves a snapshot automatically whenever your configuration changes, such as when you add, edit, rename, or delete a printer, or when printers are synced to the cloud. These appear with an AUTO tag and a short description of what changed (for example, "Added Snapmaker U1" or "Synced 1 printer(s) to cloud").

Fuse keeps the 20 most recent automatic snapshots. Once that limit is reached, the oldest automatic snapshot is removed as new ones are taken.

Manual Snapshots (Named Checkpoints)

You can also save a named checkpoint at any time, which is handy before making a big change like a firmware update or reorganizing your printers. In Settings, under Printer Management → Save Configuration, click Save, give the checkpoint a descriptive name (for example, "Before firmware update"), and click Save.

Manual checkpoints are kept separately from automatic snapshots so routine autosaves can't crowd them out. Fuse keeps your 10 most recent manual checkpoints; beyond that, the oldest is removed when you save a new one.

Restoring a Configuration

To roll back to an earlier configuration, open the Restore configuration dialog and choose the revision you want. Each entry shows its name, an AUTO tag for automatic snapshots, the number of printers it contained, and when it was saved.

• Save current config before restoring: Leave this checked (the default) to automatically save a snapshot of your current setup before the restore, so you can undo the restore if needed.
• Select a revision and click Save & Restore to apply it.

Restoring From Other Fuse Clients

If you run more than one Fuse client on the same Printago account, the Other Fuse Clients section of the Restore dialog lists snapshots saved by your other clients. This lets you copy a configuration from one machine to another, for example to migrate your setup to a new computer or replicate it across multiple Fuse instances. Select one of those revisions and click Save & Restore to apply it to the current client.

Exporting and Importing

In addition to in-app snapshots, you can Export your configuration to a JSON file (in Settings → Printer Management → Save Configuration) and import it later or into another Fuse client. See Importing Configuration for the import steps.

Files

The Files page shows all cached print files on your Fuse client.

For each file, you can see:

• Filename: The original print file name
• Size: File size on disk
• Created: When the file was cached

Actions available:

• Download: Save the file to your computer
• Delete: Remove the file from the cache

Cache settings can be adjusted in the Settings page.

Settings

Access the Settings page from the top navigation menu to manage your Fuse client.

Fuse Gateway

• Fuse Gateway URL: The endpoint for cloud connectivity (default: gateway.printago.io)
• Enable Gateway Connection: Toggle to enable/disable cloud sync with Printago

Printer Management

• Save Configuration: Save the current printer configuration as a named checkpoint, or Export it to a JSON file as a backup. See Configuration Snapshots for details on snapshots and restoring.
• Sync Printers to Cloud: Manually trigger a sync of all printer data to Printago
• Clear Printers: Remove all printer configurations from this Fuse client

External Integrations

• Real-time Stats WebSocket: Enable a WebSocket server on port 8889 for external applications to receive live printer data

File Cache

• Cache Size: Set the maximum cache size in GB (e.g., 10 GB)
• Usage Display: Shows current cache usage
• Clear Cache: Remove all cached files

Troubleshooting

• Restart Fuse Client: Restart the client to reload configuration and cycle connections. Use when troubleshooting connection issues or after configuration changes.
• Logs: View and download Fuse logs for debugging
• Auth Token: Shows your current authentication token for support purposes
• Allowed Printers: Display the list of printer IDs this client is authorized to manage

Software Updates

When a newer version of Fuse is available, an Update Available banner appears at the top of the Settings page. Desktop apps download the update automatically and offer a Quit and Install Update button; Docker deployments show the commands needed to pull the new image. Updating is safe to do during active prints. See Updating Fuse for full details.

Danger Zone

The following operations are destructive. Use with caution.

Deactivate

• Disconnects this Fuse client from your Printago account
• Preserves all printer configurations locally
• Your printers remain configured but won't sync with Printago
• You'll need to reactivate to sync with Printago again
• Use when temporarily disconnecting Fuse or switching accounts

Reset

• Complete reset: disconnects from Printago AND removes all printer configurations
• Returns Fuse to its initial state
• You'll need to reactivate and reconfigure all printers from scratch
• Use when setting up a new account or troubleshooting severe issues

Troubleshooting

Printers Not Discovered

If auto-scan isn't finding your printers:

1. Verify printers are on the same network as your Fuse client
2. Confirm LAN Mode and Developer Mode are enabled on the printer
3. Check that your firewall allows SSDP traffic (UDP ports 1990, 2021)
4. Try a custom subnet scan with your network's subnet
5. As a last resort, add the printer manually if you know its IP address

Connection Issues

If Fuse shows as disconnected from Printago:

1. Check your internet connection
2. Verify the Fuse client is running (check Status page)
3. Try restarting the Fuse client from Settings
4. Check that the Gateway URL is correct in Settings
5. If issues persist, deactivate and reactivate

Printer Won't Connect

If a configured printer shows as disconnected:

1. Verify the printer is powered on and connected to the network
2. Check that the IP address hasn't changed (some networks use dynamic IPs)
3. Confirm the access code is correct
4. Ensure LAN Mode and Developer Mode are enabled
5. Check that port 8883 isn't blocked by your firewall
6. View the MQTT Communications to diagnose connection issues
7. Try removing and re-adding the printer

File Upload Issues

If print jobs are stuck being sent to the printer or fail to upload:

USB storage models (X2D, P2S, H2 series): These printers store files sent over the local network on a USB flash drive. If no drive is inserted, every upload fails, and the Fuse logs show an error like FTP upload failed ... 553 Could not create file. Insert a USB drive (formatted FAT32 or exFAT) and try again. The internal storage on these models cannot receive files over FTPS, so Fuse cannot fall back to it.

MicroSD models (X1, P1, A1 series): The same applies if the microSD card is removed, full, or not formatted correctly.

General troubleshooting:

1. Check the Fuse logs in Settings for detailed error messages
2. Ensure the printer has adequate storage space
3. Verify network connectivity between Fuse and the printer
4. Try restarting the Fuse client if uploads consistently fail

Camera Not Loading

If the camera feed doesn't appear:

1. Verify the printer camera is enabled in printer settings
2. Check that port 6000 isn't blocked by your firewall
3. Some networks may block RTSP streams; try from a different network
4. Restart the printer if the issue persists

Technical Details

• Control Protocol: MQTT over TLS (port 8883)
• File Transfer: FTP over TLS (port 990)
• Discovery: SSDP (UDP ports 1990, 2021)
• Camera Stream: RTSP (ports 322, 6000)
• Stats API: WebSocket (port 8889, optional)
• Network: Local network connection required
• Activation: Time-limited codes (15-minute expiration)
• Virtual Printers: Up to 20 per Fuse client
• Supported Models: All current Bambu Lab FDM printers (X1 series, X2D, P1 series, P2S, A1 series, H2 series). Models that store files on a USB drive need one inserted; see File Upload Issues.

Support

For additional help, visit docs.printago.io/fuse or contact Printago support.