# Copy to .env next to docker-compose.yml and edit.
# Every value here has a working default — nothing is required to start.

# --- identity / host --------------------------------------------------------
# Must match the owner of the directories below, or Beltr can't write to them.
# Find yours with: id -u ; id -g
PUID=1000
PGID=1000
TZ=Etc/UTC

# Uncommon by design, so it doesn't collide with the usual self-hosted suspects.
BELTR_PORT=8477

# --- storage ----------------------------------------------------------------
# Small and frequently written — SSD if you have one.
BELTR_CONFIG_DIR=./config
# Separated stems: roughly 60-120 MB per song. Point this at bulk storage.
BELTR_LIBRARY_DIR=./library
# Your existing music. Mounted read-only; Beltr copies what it imports.
BELTR_MEDIA_DIR=./media

# --- license ----------------------------------------------------------------
# Your key from https://beltr.app/buy. Activates once against this install's
# identity (a UUID kept in /config) and then works offline; recreating or
# updating the container does not re-activate. Leave blank for the trial —
# five songs, then it asks you to buy.
#
# The identity lives on the /config volume, so keep that volume when you
# update. If you delete it you'll need to re-activate, which uses another of
# the key's device slots.
#
# You can also put the key in a file at /config/license.key instead.
BELTR_LICENSE_KEY=

# --- optional ---------------------------------------------------------------
# Image tag. `latest` for CPU; the gpu profile appends -cuda automatically.
BELTR_TAG=latest

# Fixed host PIN for privileged actions. Unset = randomised every start.
KARAOKE_HOST_PIN=

# Whisper transcription model. Only used when no lyrics provider has the song,
# so most tracks never touch it. On a CPU-only server, large-v3-turbo is much
# faster for the ones that do.
WHISPER_MODEL_SIZE=large-v3

# Separation model. htdemucs is the shipped default and the only one seeded in
# the image; anything else downloads on first use. htdemucs_ft is roughly 4x
# the compute for a small quality gain — reasonable on a server, not on a NAS.
DEMUCS_MODEL=htdemucs

# Password for the TV/dashboard pages and the management endpoints. Phones
# joining a room never need it. Read the security note in docs/UNRAID.md
# before treating this as protection against anything but your own household.
AUTH_PASSWORD=

# Ownership fixing at startup: first-run | always | never
BELTR_FIX_PERMS=first-run