Installation

Installation

Docker quick start

mkdir printbuddy
cd printbuddy
curl -fsSLO https://raw.githubusercontent.com/vmhomelab/Printbuddy/main/docker-compose.yml
docker compose up -d

Open:

http://<docker-host-ip>:8000

On Linux, the compose file uses network_mode: host so Bambu discovery, camera traffic, and virtual-printer ports work correctly.

On Docker Desktop for macOS/Windows, network_mode: host is not supported. Remove/comment network_mode: host and enable the ports: block in the compose file instead.

Native install

For native Linux installs, use the install script from the Printbuddy repository:

curl -fsSL https://raw.githubusercontent.com/vmhomelab/Printbuddy/main/install/install.sh   -o /tmp/install.sh
sudo bash /tmp/install.sh --path /opt/printbuddy

First login and setup

1. Open the web UI.
2. Add your printer by IP/hostname.
3. For Bambu Lab printers, make sure LAN access / Developer Mode is enabled where required.
4. Configure archive, notification, and automation settings as needed.