Requirements

Requirements

Recommended deployment

The recommended deployment method is Docker Compose on a Linux host.

Recommended host:

• Linux server, VM, or mini PC
• Docker Engine with Docker Compose plugin
• Persistent storage for /app/data and /app/logs
• Network access to the printers

Supported container architectures:

• amd64 for Intel/AMD systems
• arm64 for Raspberry Pi 4/5 and similar ARM64 hosts

Network requirements

Printbuddy should be able to reach each printer directly.

Recommended:

• Put Printbuddy and the printers on the same trusted LAN/VLAN where possible.
• Use stable printer IP addresses or DHCP reservations.
• Allow printer API ports between the Printbuddy host and printers.
• For Linux Docker deployments, use network_mode: host when using Bambu discovery, camera streaming, or virtual-printer ports.

Printer-specific requirements

Bambu Lab

• LAN access / Developer Mode enabled where required.
• Printer IP or hostname.
• Access code.
• Serial number when required.

Klipper / Moonraker

• Moonraker reachable from the Printbuddy host.
• Default Moonraker URL is usually http://<printer-ip>:7125.
• Optional Moonraker token if Moonraker authorization is enabled.

PrusaLink

• PrusaLink reachable from the Printbuddy host.
• PrusaLink credentials or API secret.

Prusa Connect

• Internet access from the Printbuddy host.
• Prusa Connect printer UUID.
• Prusa Connect token.

Browser requirements

Use a current desktop browser such as Firefox, Chrome, Edge, or Safari.

Storage requirements

Print archives, thumbnails, logs, databases, and backups can grow over time. Put the Docker volumes on storage that is backed up and has enough free space for your expected print history.