khord

khord

Aplicación Docker from khord's Repository

Visión general

Khord is a self-hosted music sharing app. Share a song once — everyone listens on whichever streaming service they use (Spotify, Apple Music, YouTube Music, Deezer, and more). Setlists, upvoting, cross-platform links, and an admin panel all included. All data stored in a single SQLite database — no external services required. No reverse proxy is included — point your existing Unraid reverse proxy (NGINX Proxy Manager, Swag, Traefik, etc.) at port 3000 on this container. HTTPS is required for a publicly accessible instance.

Argumentos en tiempo de ejecución

Interfaz web
http://[IP]:[PORT:3000]/
Red
bridge
Concha
sh
Privilegiado
false

Configuración de plantillas

Web UI PortPorttcp

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.

Objetivo
3000
Por defecto
3000
Valor
3000
Data PathPathrw

Directory where the SQLite database and thumbnail cache are stored.

Objetivo
/data
Por defecto
/mnt/user/appdata/khord/data
Valor
/mnt/user/appdata/khord/data
App URLVariable

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

Objetivo
PUBLIC_APP_URL
Por defecto
https://khord.yourdomain.com
Owner EmailsVariable

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

Objetivo
OWNER_EMAILS
Spotify Client IDVariable

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.

Objetivo
PUBLIC_SPOTIFY_CLIENT_ID
Spotify Client SecretVariable

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.

Objetivo
SPOTIFY_CLIENT_SECRET
YouTube API KeyVariable

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

Objetivo
YOUTUBE_API_KEY
Apple Music Developer TokenVariable

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.

Objetivo
PUBLIC_APPLE_MUSIC_DEV_TOKEN
Max UsersVariable

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

Objetivo
MAX_USERS
Por defecto
0
Valor
0
App NameVariable

Display name shown in the UI and page titles.

Objetivo
PUBLIC_APP_NAME
Por defecto
Khord
Valor
Khord
App TaglineVariable

One-line tagline shown on the home page.

Objetivo
PUBLIC_APP_TAGLINE
Por defecto
Share music, listen anywhere.
Valor
Share music, listen anywhere.
Disable Album ArtVariable

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

Objetivo
DISABLE_ALBUM_ART
Por defecto
false
Valor
false
ThemeVariable

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.

Objetivo
PUBLIC_THEME
Por defecto
dark
Valor
dark
Database File NameVariable

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

Objetivo
INDEXER_DB_NAME
Por defecto
khord.db
Valor
khord.db
Thumbnail Cache DirectoryVariable

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

Objetivo
THUMBNAIL_CACHE_DIR
Por defecto
/data/thumbnails
Valor
/data/thumbnails

Detalles

Repositorio
ghcr.io/khordapp/khord:latest
Última actualización2026-05-31
Visto por primera vez2026-05-31

Ejecute Khord en Unraid.

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