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.

目标

3000

默认值

3000

价值

3000

Directory where the SQLite database and thumbnail cache are stored.

目标

/data

默认值

/mnt/user/appdata/khord/data

价值

/mnt/user/appdata/khord/data

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

目标

PUBLIC_APP_URL

默认值

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.

目标

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.

目标

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.

目标

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).

目标

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.

目标

PUBLIC_APPLE_MUSIC_DEV_TOKEN

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

目标

MAX_USERS

默认值

0

价值

0

Display name shown in the UI and page titles.

目标

PUBLIC_APP_NAME

默认值

Khord

价值

Khord

One-line tagline shown on the home page.

目标

PUBLIC_APP_TAGLINE

默认值

Share music, listen anywhere.

价值

Share music, listen anywhere.

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

目标

DISABLE_ALBUM_ART

默认值

false

价值

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.

目标

PUBLIC_THEME

默认值

dark

价值

dark

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

目标

INDEXER_DB_NAME

默认值

khord.db

价值

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).

目标

THUMBNAIL_CACHE_DIR

默认值

/data/thumbnails

价值

/data/thumbnails