Octave web interface and API.

Objetivo

8000

Por defecto

8000

Valor

8000

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

Objetivo

/app/config

Por defecto

/mnt/user/appdata/octave/config

Valor

/mnt/user/appdata/octave/config

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

Objetivo

/app/data

Por defecto

/mnt/user/appdata/octave/data

Valor

/mnt/user/appdata/octave/data

Octave log files (rotated automatically).

Objetivo

/app/logs

Por defecto

/mnt/user/appdata/octave/logs

Valor

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

Objetivo

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.

Objetivo

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.

Objetivo

JELLYFIN_URL

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

Objetivo

JELLYFIN_API_KEY

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

Objetivo

JELLYFIN_USER_ID

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

Objetivo

LIDARR_URL

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

Objetivo

LIDARR_API_KEY

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

Objetivo

AUTH_USERNAME

Por defecto

octave

Valor

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.

Objetivo

AUTH_PASSWORD

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

Objetivo

SYNC_SCHEDULE

Por defecto

0 2 * * *

Valor

0 2 * * *

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

Objetivo

SYNC_ON_STARTUP

Por defecto

false

Valor

false

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

Objetivo

SYNC_ALL_PLAYLISTS

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

Objetivo

TZ

Por defecto

UTC

Valor

UTC

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

Objetivo

LOG_LEVEL

Por defecto

INFO

Valor

INFO

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

Objetivo

LISTENBRAINZ_TOKEN

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

Objetivo

LASTFM_API_KEY

Optional. Last.fm username for scrobble history lookups.

Objetivo

LASTFM_USERNAME