PrintLab

PrintLab

Docker-Anwendung from techpunk's repo

Übersicht

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.

Anforderungen

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

Laufzeit-Argumente

Web-UI
http://[IP]:[PORT:8080]/
Netzwerk
makerworks-net
Shell
bash
Privilegiert
false
Extra Params
--restart unless-stopped

Konfiguration der Vorlage

Web UI PortPorttcp

Host port for the PrintLab web UI.

Ziel
8080
Standard
8983
Wert
8983
Data PathPathrw

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

Ziel
/data
Standard
/mnt/user/appdata/printlab/data
Wert
/mnt/user/appdata/printlab/data
Config PathPathrw

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

Ziel
/config
Standard
/mnt/user/appdata/printlab/config
Wert
/mnt/user/appdata/printlab/config
TimezoneVariable

Container timezone.

Ziel
TZ
Standard
Etc/UTC
Wert
Etc/UTC
Log LevelVariable

Application log level.

Ziel
LOG_LEVEL
Standard
INFO
Wert
INFO
PRINTERS_JSONVariable

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

Printer NameVariable

Friendly name for single-printer mode.

Ziel
PRINTER_NAME
Printer HostVariable

Single-printer LAN IP or hostname.

Ziel
PRINTER_HOST
Printer SerialVariable

Single-printer serial number.

Ziel
PRINTER_SERIAL
Printer Access CodeVariable

Single-printer LAN access code.

Ziel
PRINTER_ACCESS_CODE
Printer Device TypeVariable

Printer device type override.

Ziel
PRINTER_DEVICE_TYPE
Standard
unknown
Wert
unknown
Local MQTTVariable

Use local MQTT mode.

Ziel
PRINTER_LOCAL_MQTT
Standard
true
Wert
true
Enable CameraVariable

Enable camera retrieval.

Ziel
PRINTER_ENABLE_CAMERA
Standard
true
Wert
true
Disable SSL VerifyVariable

Disable SSL verification for printer/cloud calls.

Ziel
PRINTER_DISABLE_SSL_VERIFY
Standard
false
Wert
false
File Cache PathVariable

Internal cache path.

Ziel
FILE_CACHE_PATH
Standard
/data/cache
Wert
/data/cache
Print Cache CountVariable

Cached print records count.

Ziel
PRINT_CACHE_COUNT
Standard
1
Wert
1
Timelapse Cache CountVariable

Cached timelapse records count.

Ziel
TIMELAPSE_CACHE_COUNT
Standard
1
Wert
1
Bambu RegionVariable

Optional Bambu cloud region.

Ziel
BAMBU_REGION
Bambu EmailVariable

Optional Bambu cloud email.

Ziel
BAMBU_EMAIL
Bambu UsernameVariable

Optional Bambu cloud username.

Ziel
BAMBU_USERNAME
Bambu Auth TokenVariable

Optional Bambu cloud auth token.

Ziel
BAMBU_AUTH_TOKEN
Require AuthVariable

Require login for UI and API access.

Ziel
REQUIRE_AUTH
Standard
true
Wert
true
Admin UsernameVariable

Admin login username.

Ziel
ADMIN_USERNAME
Standard
admin
Wert
admin
Admin EmailVariable

Optional admin login email.

Ziel
ADMIN_EMAIL
Admin Password HashVariable

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

Ziel
ADMIN_PASSWORD_HASH
Session SecretVariable

Required long random secret used to sign session cookies.

Ziel
SESSION_SECRET
Session Cookie SecureVariable

Set true when serving behind HTTPS.

Ziel
SESSION_COOKIE_SECURE
Standard
false
Wert
false
MakerWorks Base URLVariable

MakerWorks API base URL on makerworks-net.

Ziel
MAKERWORKS_BASE_URL
Standard
http://MakerWorks-v2:3000
Wert
http://MakerWorks-v2:3000
MakerWorks API KeyVariable

Optional MakerWorks API key.

Ziel
MAKERWORKS_API_KEY
MakerWorks Bearer TokenVariable

Optional MakerWorks bearer token.

Ziel
MAKERWORKS_BEARER_TOKEN
MakerWorks Auth HeaderVariable

Header used for MakerWorks API key.

Ziel
MAKERWORKS_AUTH_HEADER
Standard
X-API-Key
Wert
X-API-Key
MakerWorks Webhook SecretVariable

Shared secret for callbacks sent to MakerWorks.

Ziel
MAKERWORKS_WEBHOOK_SECRET
MakerWorks Submit API KeyVariable

API key accepted for MakerWorks submit boundary routes.

Ziel
MAKERWORKS_SUBMIT_API_KEY
MakerWorks Allowed PathsVariable

Comma-separated allowlist for MakerWorks proxy paths.

Ziel
MAKERWORKS_ALLOWED_PATHS
Standard
/health,/api/models
Wert
/health,/api/models
MakerWorks Job Callback EnabledVariable

Send job status callbacks to MakerWorks.

Ziel
MAKERWORKS_JOB_CALLBACK_ENABLED
Standard
false
Wert
false
MakerWorks Job Callback Path TemplateVariable

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

Ziel
MAKERWORKS_JOB_CALLBACK_PATH_TEMPLATE
StockWorks Base URLVariable

Optional StockWorks API base URL.

Ziel
STOCKWORKS_BASE_URL
Standard
http://StockWorks:8000
Wert
http://StockWorks:8000
StockWorks API KeyVariable

Optional StockWorks API key.

Ziel
STOCKWORKS_API_KEY
YouTube Upload EnabledVariable

Enable automatic timelapse uploads to YouTube.

Ziel
YOUTUBE_UPLOAD_ENABLED
Standard
false
Wert
false
YouTube Client IDVariable

OAuth client ID for YouTube uploads.

Ziel
YOUTUBE_CLIENT_ID
YouTube Client SecretVariable

OAuth client secret for YouTube uploads.

Ziel
YOUTUBE_CLIENT_SECRET
YouTube Refresh TokenVariable

OAuth refresh token for YouTube uploads.

Ziel
YOUTUBE_REFRESH_TOKEN

Einzelheiten

Repository
ghcr.io/schartrand77/printlab:latest
Zuletzt aktualisiert2026-05-31
Erstmals gesehen2026-05-04

Führen Sie PrintLab auf Unraid aus.

PrintLab ist gelistet in Community Apps für Unraid OS. Erkunden Sie Unraid, um einen flexiblen Heimserver, ein NAS oder ein Heimlabor aufzubauen.