PrintLab

PrintLab

Aplicación Docker from techpunk's repo

Visión general

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.

Requisitos

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

Argumentos en tiempo de ejecución

Interfaz web
http://[IP]:[PORT:8080]/
Red
makerworks-net
Concha
bash
Privilegiado
false
Parámetros adicionales
--restart unless-stopped

Configuración de plantillas

Web UI PortPorttcp

Host port for the PrintLab web UI.

Objetivo
8080
Por defecto
8983
Valor
8983
Data PathPathrw

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

Objetivo
/data
Por defecto
/mnt/user/appdata/printlab/data
Valor
/mnt/user/appdata/printlab/data
Config PathPathrw

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

Objetivo
/config
Por defecto
/mnt/user/appdata/printlab/config
Valor
/mnt/user/appdata/printlab/config
TimezoneVariable

Container timezone.

Objetivo
TZ
Por defecto
Etc/UTC
Valor
Etc/UTC
Log LevelVariable

Application log level.

Objetivo
LOG_LEVEL
Por defecto
INFO
Valor
INFO
PRINTERS_JSONVariable

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

Printer NameVariable

Friendly name for single-printer mode.

Objetivo
PRINTER_NAME
Printer HostVariable

Single-printer LAN IP or hostname.

Objetivo
PRINTER_HOST
Printer SerialVariable

Single-printer serial number.

Objetivo
PRINTER_SERIAL
Printer Access CodeVariable

Single-printer LAN access code.

Objetivo
PRINTER_ACCESS_CODE
Printer Device TypeVariable

Printer device type override.

Objetivo
PRINTER_DEVICE_TYPE
Por defecto
unknown
Valor
unknown
Local MQTTVariable

Use local MQTT mode.

Objetivo
PRINTER_LOCAL_MQTT
Por defecto
true
Valor
true
Enable CameraVariable

Enable camera retrieval.

Objetivo
PRINTER_ENABLE_CAMERA
Por defecto
true
Valor
true
Disable SSL VerifyVariable

Disable SSL verification for printer/cloud calls.

Objetivo
PRINTER_DISABLE_SSL_VERIFY
Por defecto
false
Valor
false
File Cache PathVariable

Internal cache path.

Objetivo
FILE_CACHE_PATH
Por defecto
/data/cache
Valor
/data/cache
Print Cache CountVariable

Cached print records count.

Objetivo
PRINT_CACHE_COUNT
Por defecto
1
Valor
1
Timelapse Cache CountVariable

Cached timelapse records count.

Objetivo
TIMELAPSE_CACHE_COUNT
Por defecto
1
Valor
1
Bambu RegionVariable

Optional Bambu cloud region.

Objetivo
BAMBU_REGION
Bambu EmailVariable

Optional Bambu cloud email.

Objetivo
BAMBU_EMAIL
Bambu UsernameVariable

Optional Bambu cloud username.

Objetivo
BAMBU_USERNAME
Bambu Auth TokenVariable

Optional Bambu cloud auth token.

Objetivo
BAMBU_AUTH_TOKEN
Require AuthVariable

Require login for UI and API access.

Objetivo
REQUIRE_AUTH
Por defecto
true
Valor
true
Admin UsernameVariable

Admin login username.

Objetivo
ADMIN_USERNAME
Por defecto
admin
Valor
admin
Admin EmailVariable

Optional admin login email.

Objetivo
ADMIN_EMAIL
Admin Password HashVariable

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

Objetivo
ADMIN_PASSWORD_HASH
Session SecretVariable

Required long random secret used to sign session cookies.

Objetivo
SESSION_SECRET
Session Cookie SecureVariable

Set true when serving behind HTTPS.

Objetivo
SESSION_COOKIE_SECURE
Por defecto
false
Valor
false
MakerWorks Base URLVariable

MakerWorks API base URL on makerworks-net.

Objetivo
MAKERWORKS_BASE_URL
Por defecto
http://MakerWorks-v2:3000
Valor
http://MakerWorks-v2:3000
MakerWorks API KeyVariable

Optional MakerWorks API key.

Objetivo
MAKERWORKS_API_KEY
MakerWorks Bearer TokenVariable

Optional MakerWorks bearer token.

Objetivo
MAKERWORKS_BEARER_TOKEN
MakerWorks Auth HeaderVariable

Header used for MakerWorks API key.

Objetivo
MAKERWORKS_AUTH_HEADER
Por defecto
X-API-Key
Valor
X-API-Key
MakerWorks Webhook SecretVariable

Shared secret for callbacks sent to MakerWorks.

Objetivo
MAKERWORKS_WEBHOOK_SECRET
MakerWorks Submit API KeyVariable

API key accepted for MakerWorks submit boundary routes.

Objetivo
MAKERWORKS_SUBMIT_API_KEY
MakerWorks Allowed PathsVariable

Comma-separated allowlist for MakerWorks proxy paths.

Objetivo
MAKERWORKS_ALLOWED_PATHS
Por defecto
/health,/api/models
Valor
/health,/api/models
MakerWorks Job Callback EnabledVariable

Send job status callbacks to MakerWorks.

Objetivo
MAKERWORKS_JOB_CALLBACK_ENABLED
Por defecto
false
Valor
false
MakerWorks Job Callback Path TemplateVariable

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

Objetivo
MAKERWORKS_JOB_CALLBACK_PATH_TEMPLATE
StockWorks Base URLVariable

Optional StockWorks API base URL.

Objetivo
STOCKWORKS_BASE_URL
Por defecto
http://StockWorks:8000
Valor
http://StockWorks:8000
StockWorks API KeyVariable

Optional StockWorks API key.

Objetivo
STOCKWORKS_API_KEY
YouTube Upload EnabledVariable

Enable automatic timelapse uploads to YouTube.

Objetivo
YOUTUBE_UPLOAD_ENABLED
Por defecto
false
Valor
false
YouTube Client IDVariable

OAuth client ID for YouTube uploads.

Objetivo
YOUTUBE_CLIENT_ID
YouTube Client SecretVariable

OAuth client secret for YouTube uploads.

Objetivo
YOUTUBE_CLIENT_SECRET
YouTube Refresh TokenVariable

OAuth refresh token for YouTube uploads.

Objetivo
YOUTUBE_REFRESH_TOKEN

Detalles

Repositorio
ghcr.io/schartrand77/printlab:latest
Última actualización2026-06-01
Visto por primera vez2026-05-04

Ejecute PrintLab en Unraid.

PrintLab se encuentra en Community Apps para Unraid OS. Explore Unraid para crear un servidor doméstico flexible, un NAS o un laboratorio doméstico.