First Setup

First Setup

This page covers the first steps after installing Printbuddy.

1. Open the web UI

Open Printbuddy in your browser:

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

If you changed the PORT environment variable, use that port instead.

2. Complete initial setup

On a fresh install, Printbuddy may ask you to create the first user or configure basic settings.

Recommended first settings:

• Timezone, for example Europe/Berlin.
• Storage/backups location.
• Authentication if the instance is reachable by more than one person.
• Notification provider only after printer connectivity is working.

3. Add your first printer

Go to the printer setup area and choose the correct provider:

• Bambu Lab for Bambu printers.
• Klipper / Fluidd / Mainsail for Moonraker printers.
• PrusaLink for local PrusaLink printers.
• Prusa Connect for Prusa cloud/mobile API connections.

See Add a Printer for provider-specific fields.

4. Verify status

After adding a printer, check:

• The printer card appears on the dashboard.
• Status and temperatures load.
• Camera opens if configured.
• Logs do not show repeated connection failures.

5. Configure optional features

Once the printer connection is stable, configure optional features:

• Print archive behavior.
• Queue / review / proxy workflows.
• Notifications.
• Backups.
• Home Assistant integration.
• Spoolman or MQTT integrations if used in your environment.