Octave web interface and API.

Cible

8000

Défaut

8000

Valeur

8000

Stores config.json (non-secret settings: Jellyfin library ID, playlists list).

Cible

/app/config

Défaut

/mnt/user/appdata/octave/config

Valeur

/mnt/user/appdata/octave/config

Runtime data: SQLite sync history, credentials (settings.json), Spotify PKCE token, track cache.

Cible

/app/data

Défaut

/mnt/user/appdata/octave/data

Valeur

/mnt/user/appdata/octave/data

Octave log files (rotated automatically).

Cible

/app/logs

Défaut

/mnt/user/appdata/octave/logs

Valeur

/mnt/user/appdata/octave/logs

Required to connect Spotify. Create a free app at developer.spotify.com/dashboard, copy its Client ID here (or into Settings later), and add your Octave callback URL — http://SERVER-IP:8000/callback — to that app's Redirect URIs. PKCE is used, so no client secret is needed.

Cible

SPOTIFY_CLIENT_ID

Optional. Leave blank to let Octave infer the callback URI. Set this explicitly when using a reverse proxy, e.g. https://octave.example.com/callback.

Cible

SPOTIFY_REDIRECT_URI

Optional — use 'Sign in to Jellyfin' in the Settings UI to configure automatically. URL reachable from the Octave container, e.g. http://192.168.1.10:8096 or http://jellyfin:8096.

Cible

JELLYFIN_URL

Optional — auto-filled by 'Sign in to Jellyfin' in Settings. Jellyfin Dashboard → API Keys.

Cible

JELLYFIN_API_KEY

Optional — auto-filled by 'Sign in to Jellyfin' in Settings. The user ID that will own created playlists.

Cible

JELLYFIN_USER_ID

Optional — leave unset to disable Lidarr integration. URL reachable from the Octave container, e.g. http://lidarr:8686.

Cible

LIDARR_URL

Optional Lidarr API key. Lidarr → Settings → General → Security → API Key.

Cible

LIDARR_API_KEY

HTTP Basic Auth username for the web UI. Defaults to 'octave'.

Cible

AUTH_USERNAME

Défaut

octave

Valeur

octave

SECURITY: blank = NO authentication (anyone on the network can access Octave). Set a password before exposing Octave beyond a trusted LAN. Leave blank only for an isolated/LAN-trust setup.

Cible

AUTH_PASSWORD

Cron schedule for automatic sync (uses container TZ). Default: 2:00 AM daily. Leave blank to disable scheduled sync.

Cible

SYNC_SCHEDULE

Défaut

0 2 * * *

Valeur

0 2 * * *

Set to 'true' to run a sync when the container starts.

Cible

SYNC_ON_STARTUP

Défaut

false

Valeur

false

Set to 'true' to discover and sync every Spotify playlist the connected account can see. Spotify-owned editorial playlists are skipped automatically.

Cible

SYNC_ALL_PLAYLISTS

IANA timezone string for logs and scheduled syncs, e.g. Australia/Sydney.

Cible

TZ

Défaut

UTC

Valeur

UTC

Python logging level: DEBUG, INFO, WARNING, or ERROR.

Cible

LOG_LEVEL

Défaut

INFO

Valeur

INFO

Optional. ListenBrainz user token from listenbrainz.org/profile/ — enables MusicBrainz ID resolution for better Lidarr matching.

Cible

LISTENBRAINZ_TOKEN

Optional. Last.fm API key from last.fm/api/account/create — enables playcounts and similar-artist discovery.

Cible

LASTFM_API_KEY

Optional. Last.fm username for scrobble history lookups.

Cible

LASTFM_USERNAME