Octave web interface and API.

Ziel

8000

Standard

8000

Wert

8000

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

Ziel

/app/config

Standard

/mnt/user/appdata/octave/config

Wert

/mnt/user/appdata/octave/config

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

Ziel

/app/data

Standard

/mnt/user/appdata/octave/data

Wert

/mnt/user/appdata/octave/data

Octave log files (rotated automatically).

Ziel

/app/logs

Standard

/mnt/user/appdata/octave/logs

Wert

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

Ziel

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.

Ziel

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.

Ziel

JELLYFIN_URL

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

Ziel

JELLYFIN_API_KEY

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

Ziel

JELLYFIN_USER_ID

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

Ziel

LIDARR_URL

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

Ziel

LIDARR_API_KEY

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

Ziel

AUTH_USERNAME

Standard

octave

Wert

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.

Ziel

AUTH_PASSWORD

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

Ziel

SYNC_SCHEDULE

Standard

0 2 * * *

Wert

0 2 * * *

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

Ziel

SYNC_ON_STARTUP

Standard

false

Wert

false

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

Ziel

SYNC_ALL_PLAYLISTS

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

Ziel

TZ

Standard

UTC

Wert

UTC

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

Ziel

LOG_LEVEL

Standard

INFO

Wert

INFO

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

Ziel

LISTENBRAINZ_TOKEN

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

Ziel

LASTFM_API_KEY

Optional. Last.fm username for scrobble history lookups.

Ziel

LASTFM_USERNAME