PrintLab

PrintLab

Application Docker from techpunk's repo

Vue d'ensemble

PrintLab is a standalone dashboard and API for Bambu printers with multi-printer monitoring, printer job tracking, MakerWorks handoff, StockWorks filament lookup, and optional timelapse upload support.

Exigences

Mapped /data and /config paths, printer credentials or PRINTERS_JSON, admin password hash, session secret, and Docker network makerworks-net.

Arguments d'exécution

Interface utilisateur Web
http://[IP]:[PORT:8080]/
Réseau
makerworks-net
Coquille
bash
Privilégié
false
Paramètres supplémentaires
--restart unless-stopped

Configuration du modèle

Web UI PortPorttcp

Host port for the PrintLab web UI.

Cible
8080
Défaut
8983
Valeur
8983
Data PathPathrw

Persistent PrintLab data, cache, submitted jobs, and successful G-code records.

Cible
/data
Défaut
/mnt/user/appdata/printlab/data
Valeur
/mnt/user/appdata/printlab/data
Config PathPathrw

Optional PrintLab config.json and file-based secret directory.

Cible
/config
Défaut
/mnt/user/appdata/printlab/config
Valeur
/mnt/user/appdata/printlab/config
TimezoneVariable

Container timezone.

Cible
TZ
Défaut
Etc/UTC
Valeur
Etc/UTC
Log LevelVariable

Application log level.

Cible
LOG_LEVEL
Défaut
INFO
Valeur
INFO
PRINTERS_JSONVariable

Optional multi-printer JSON array. If set, overrides single PRINTER_* values.

Printer NameVariable

Friendly name for single-printer mode.

Cible
PRINTER_NAME
Printer HostVariable

Single-printer LAN IP or hostname.

Cible
PRINTER_HOST
Printer SerialVariable

Single-printer serial number.

Cible
PRINTER_SERIAL
Printer Access CodeVariable

Single-printer LAN access code.

Cible
PRINTER_ACCESS_CODE
Printer Device TypeVariable

Printer device type override.

Cible
PRINTER_DEVICE_TYPE
Défaut
unknown
Valeur
unknown
Local MQTTVariable

Use local MQTT mode.

Cible
PRINTER_LOCAL_MQTT
Défaut
true
Valeur
true
Enable CameraVariable

Enable camera retrieval.

Cible
PRINTER_ENABLE_CAMERA
Défaut
true
Valeur
true
Disable SSL VerifyVariable

Disable SSL verification for printer/cloud calls.

Cible
PRINTER_DISABLE_SSL_VERIFY
Défaut
false
Valeur
false
File Cache PathVariable

Internal cache path.

Cible
FILE_CACHE_PATH
Défaut
/data/cache
Valeur
/data/cache
Print Cache CountVariable

Cached print records count.

Cible
PRINT_CACHE_COUNT
Défaut
1
Valeur
1
Timelapse Cache CountVariable

Cached timelapse records count.

Cible
TIMELAPSE_CACHE_COUNT
Défaut
1
Valeur
1
Bambu RegionVariable

Optional Bambu cloud region.

Cible
BAMBU_REGION
Bambu EmailVariable

Optional Bambu cloud email.

Cible
BAMBU_EMAIL
Bambu UsernameVariable

Optional Bambu cloud username.

Cible
BAMBU_USERNAME
Bambu Auth TokenVariable

Optional Bambu cloud auth token.

Cible
BAMBU_AUTH_TOKEN
Require AuthVariable

Require login for UI and API access.

Cible
REQUIRE_AUTH
Défaut
true
Valeur
true
Admin UsernameVariable

Admin login username.

Cible
ADMIN_USERNAME
Défaut
admin
Valeur
admin
Admin EmailVariable

Optional admin login email.

Cible
ADMIN_EMAIL
Admin Password HashVariable

Required hashed admin password. Generate with PrintLab scripts/hash_password.py.

Cible
ADMIN_PASSWORD_HASH
Session SecretVariable

Required long random secret used to sign session cookies.

Cible
SESSION_SECRET
Session Cookie SecureVariable

Set true when serving behind HTTPS.

Cible
SESSION_COOKIE_SECURE
Défaut
false
Valeur
false
MakerWorks Base URLVariable

MakerWorks API base URL on makerworks-net.

Cible
MAKERWORKS_BASE_URL
Défaut
http://MakerWorks-v2:3000
Valeur
http://MakerWorks-v2:3000
MakerWorks API KeyVariable

Optional MakerWorks API key.

Cible
MAKERWORKS_API_KEY
MakerWorks Bearer TokenVariable

Optional MakerWorks bearer token.

Cible
MAKERWORKS_BEARER_TOKEN
MakerWorks Auth HeaderVariable

Header used for MakerWorks API key.

Cible
MAKERWORKS_AUTH_HEADER
Défaut
X-API-Key
Valeur
X-API-Key
MakerWorks Webhook SecretVariable

Shared secret for callbacks sent to MakerWorks.

Cible
MAKERWORKS_WEBHOOK_SECRET
MakerWorks Submit API KeyVariable

API key accepted for MakerWorks submit boundary routes.

Cible
MAKERWORKS_SUBMIT_API_KEY
MakerWorks Allowed PathsVariable

Comma-separated allowlist for MakerWorks proxy paths.

Cible
MAKERWORKS_ALLOWED_PATHS
Défaut
/health,/api/models
Valeur
/health,/api/models
MakerWorks Job Callback EnabledVariable

Send job status callbacks to MakerWorks.

Cible
MAKERWORKS_JOB_CALLBACK_ENABLED
Défaut
false
Valeur
false
MakerWorks Job Callback Path TemplateVariable

Callback path, e.g. /api/printlab/jobs/{job_id}.

Cible
MAKERWORKS_JOB_CALLBACK_PATH_TEMPLATE
StockWorks Base URLVariable

Optional StockWorks API base URL.

Cible
STOCKWORKS_BASE_URL
Défaut
http://StockWorks:8000
Valeur
http://StockWorks:8000
StockWorks API KeyVariable

Optional StockWorks API key.

Cible
STOCKWORKS_API_KEY
YouTube Upload EnabledVariable

Enable automatic timelapse uploads to YouTube.

Cible
YOUTUBE_UPLOAD_ENABLED
Défaut
false
Valeur
false
YouTube Client IDVariable

OAuth client ID for YouTube uploads.

Cible
YOUTUBE_CLIENT_ID
YouTube Client SecretVariable

OAuth client secret for YouTube uploads.

Cible
YOUTUBE_CLIENT_SECRET
YouTube Refresh TokenVariable

OAuth refresh token for YouTube uploads.

Cible
YOUTUBE_REFRESH_TOKEN

Détails

Référentiel
ghcr.io/schartrand77/printlab:latest
Dernière mise à jour2026-06-02
Première vue2026-05-04

Exécutez PrintLab sur Unraid.

PrintLab est listé dans Community Apps pour Unraid OS. Explorez Unraid pour créer un serveur domestique flexible, un NAS ou un laboratoire domestique.