.env.example

# ============================================================================
# Label Printer Hub — example environment file
# Copy to .env and fill in your values. Do NOT commit your .env.
# ============================================================================

# ----- Image version --------------------------------------------------------
# Pin to a specific release for reproducibility, or use "latest" for auto-update.
# Backend and frontend MUST be the same version (they release together).
HUB_VERSION=latest

# ----- Internal ports (optional) --------------------------------------------
# The backend and frontend listen on these ports inside their containers.
# Defaults match the EXPOSE in each Dockerfile. Override only if you have
# a port conflict with another service in the same docker-compose stack.
BACKEND_PORT=8000
FRONTEND_PORT=8080

# ----- Backend proxy trust (optional) ---------------------------------------
# uvicorn FORWARDED_ALLOW_IPS — restricts which client IPs are trusted to
# set X-Forwarded-* headers. Defaults to localhost for safety. The compose
# files set this to '*' because the backend isn't directly exposed (only
# the frontend can reach it through the internal docker network).
# Override only if you understand what you're doing.
# FORWARDED_ALLOW_IPS=*

# ----- Printers (required) --------------------------------------------------
# Printers are configured via a printers.yaml file (see backend/app/seed/printers.yaml.example).
# Mount the file into the container (see compose.pangolin.yml volumes section):
#   volumes:
#     - ./printers.yaml:/etc/hub/printers.yaml:ro
#
# Override the config path if you use a different mount point:
# PRINTER_HUB_PRINTERS_CONFIG=/etc/hub/printers.yaml

# ----- Hub (required) -------------------------------------------------------
# Public hostname of the hub (used in Pangolin blueprint labels).
# Only relevant for reverse-proxy variants — for standalone, leave blank.
PRINTERHUB_HOST=printerhub.example.com

# ----- Webhook authentication (required if using webhook endpoint) ----------
# Random 32-byte hex string. Generate: openssl rand -hex 32
PRINTER_HUB_WEBHOOK_API_KEY=CHANGE_ME_GENERATE_WITH_OPENSSL_RAND_HEX_32

# ----- Database -------------------------------------------------------------
# SQLite database path inside the container.
# PRINTER_HUB_DATABASE_URL=sqlite+aiosqlite:////data/printer-hub.db

# ----- App integrations (optional) ------------------------------------------
# Snipe-IT — for asset-tag printing
# PRINTER_HUB_SNIPEIT_URL=https://snipeit.example.com
# PRINTER_HUB_SNIPEIT_API_KEY=

# Grocy — for product/storage labels
# PRINTER_HUB_GROCY_URL=https://grocy.example.com
# PRINTER_HUB_GROCY_API_KEY=

# Spoolman — for 3D printer filament spool labels
# PRINTER_HUB_SPOOLMAN_URL=https://spoolman.example.com

# ----- Logging --------------------------------------------------------------
PRINTER_HUB_LOG_LEVEL=INFO

# ----- Container UID/GID (optional) -----------------------------------------
# Override only if 1000:1000 conflicts with your host user.
# PUID=1000
# PGID=1000