Port exposed by the container. Point your reverse proxy (NGINX Proxy Manager, Swag, etc.) at this port — do not expose it directly to the internet.

Cible

3000

Défaut

3000

Valeur

3000

Directory where the SQLite database and thumbnail cache are stored.

Cible

/data

Défaut

/mnt/user/appdata/khord/data

Valeur

/mnt/user/appdata/khord/data

Publicly accessible URL for this instance, e.g. https://khord.yourdomain.com.

Cible

PUBLIC_APP_URL

Défaut

https://khord.yourdomain.com

Comma-separated email addresses granted admin/owner privileges. The first account registered with a matching email receives the admin role automatically.

Cible

OWNER_EMAILS

Spotify app client ID from developer.spotify.com. Optional — enables Spotify URL resolution and playlist import. Both Client ID and Client Secret are required together. After setting, enable Spotify in the admin panel Settings tab.

Cible

PUBLIC_SPOTIFY_CLIENT_ID

Spotify app client secret from developer.spotify.com. Required alongside Spotify Client ID. Keep this private. Note: the account that owns the Spotify app must have an active Spotify Premium subscription.

Cible

SPOTIFY_CLIENT_SECRET

YouTube Data API v3 key from console.cloud.google.com. Optional — enables YouTube Music URL resolution when sharing songs. Also enable YouTube Music in the admin panel Settings tab. Note: free quota is ~100 searches/day (100 units per call, 10,000/day limit).

Cible

YOUTUBE_API_KEY

MusicKit JWT from developer.apple.com → Keys. Optional — enables Apple Music playlist import. Requires an Apple Developer account ($99/yr). Tokens are valid up to 6 months; regenerate before expiry. After setting, enable in the instance admin panel under Settings.

Cible

PUBLIC_APPLE_MUSIC_DEV_TOKEN

Maximum number of registered users. 0 = unlimited. Can also be adjusted live from the /admin panel.

Cible

MAX_USERS

Défaut

0

Valeur

0

Display name shown in the UI and page titles.

Cible

PUBLIC_APP_NAME

Défaut

Khord

Valeur

Khord

One-line tagline shown on the home page.

Cible

PUBLIC_APP_TAGLINE

Défaut

Share music, listen anywhere.

Valeur

Share music, listen anywhere.

Set to true to hide album art thumbnails on song cards. Can also be toggled live from the /admin panel.

Cible

DISABLE_ALBUM_ART

Défaut

false

Valeur

false

UI color theme. Requires a container restart to apply. Options — neutral dark: dark, zinc, slate, gray, neutral, stone. Neutral light: light, zinc-light, slate-light, neutral-light, stone-light. Chromatic dark: navy, teal, emerald, rose, violet.

Cible

PUBLIC_THEME

Défaut

dark

Valeur

dark

File name of the SQLite database stored in the Data Path directory. Only change this if you need to rename the database file.

Cible

INDEXER_DB_NAME

Défaut

khord.db

Valeur

khord.db

Directory for the server-side album art disk cache. Lives inside the Data Path volume by default. Manage cache size from the admin panel (Admin → Cache tab).

Cible

THUMBNAIL_CACHE_DIR

Défaut

/data/thumbnails

Valeur

/data/thumbnails