One Docker stack. A short setup.
OpenPrintDash runs on your machine. You need Docker, a Bambu Lab account and your printer's serial number. The first build takes a few minutes; later starts are fast.
Clone the repository
The only requirement is Git and a terminal.
git clone https://github.com/SchlangeGoto/open-print-dashboard.git
cd open-print-dashboardCreate your environment file
Copy the example file and set POSTGRES_PASSWORD. A SECRET_KEY is generated on first start and kept in the backend data volume, or set one yourself with openssl rand -hex 32.
cp .env.example .env
# set POSTGRES_PASSWORD; SECRET_KEY is generated on first start
# set NEXT_PUBLIC_API_URL and FRONTEND_HOST for a non-localhost installStart the stack
Docker builds the frontend and backend and starts PostgreSQL. Email is optional and configured separately in the environment file.
docker compose -f compose.prod.yml up -d --buildRun the setup wizard
Open http://localhost:3000. You will create the local admin account, connect your Bambu Lab account, and add the printer.
Create account
Your local admin. No external identity provider.
Connect Bambu Lab
Used for account and history sync. Encrypted at rest.
Add printer
Pick it from the list on your Bambu account.
Finding your printer
| Value | Where to find it |
|---|---|
| Serial number | Settings, Device, Serial Number (also on the sticker on the back) |
Updating
Pull the new code, rebuild the images, and keep your database volume:
git pull
docker compose -f compose.prod.yml down
docker compose -f compose.prod.yml up -d --buildData lives in the postgres_data Docker volume and survives updates.
If something goes wrong
Port 3000 is in use. Change the frontend port mapping in compose.prod.yml.
The printer is offline. Check that it is online in Bambu Handy, and that your Bambu Lab account is connected in Settings.
The first build is slow. Docker is building the Next.js and FastAPI images. Later starts are fast.