Everything the dashboard can do today, and how each part works under the hood.
The app doesn't detect printers itself — it reads from the CUPS print server already running on your home network (or on the machine hosting this container). Whatever CUPS sees — a USB printer plugged into a server, or a network printer found via mDNS/Bonjour — appears on the dashboard automatically, with no configuration needed on your part.
Each printer card shows a colored status light: green for idle, amber (pulsing) for actively printing, red for stopped. The dashboard polls in the background every few seconds, so the status stays current without reloading the page.
A single admin account guards the dashboard and every action on it. On
first run, a default username/password is created — check with whoever
deployed this instance, or the DEFAULT_ADMIN_USERNAME /
DEFAULT_ADMIN_PASSWORD values in its configuration. Once
logged in, go to Account to set your own password —
you'll see a reminder banner until you do.
Click Jobs on any printer card to see what's currently queued. From there you can Pause a job (it stays in the queue but won't print), Resume a paused job, or Cancel a job outright.
Click + Add printer. You can either click
Scan network to have CUPS probe for reachable devices
and pick one from the list, or type a device URI directly — for example
ipp://192.168.1.50/ipp/print for a modern network printer,
or socket://192.168.1.50:9100 for raw JetDirect printing.
New printers are added in driverless (IPP Everywhere) mode, so no driver
installation is needed.
Every action beyond viewing the login page requires an active session. State-changing requests are additionally checked against a per-session CSRF token, and repeated failed logins temporarily lock out that username. None of this replaces normal network hygiene — this dashboard is designed to live on a trusted home/LAN network, not to be exposed directly to the public internet.