First Run & Setup Wizard

In AUTH_MODE=local, the first visit as the admin opens a short setup wizard. The very first login attempt creates the admin account — which is why you set ADMIN_USERNAME before first launch, so a stranger who reaches a fresh instance first can't claim it (see Authentication Modes).

Under oidc and forward there is no wizard: the admin is whoever signs in as ADMIN_USERNAME, and the provider and listening-history settings are made in Administration → Configuration. The music folder is the MUSIC_ROOT environment variable (see Environment variables).

The wizard steps

1. Confirm the music root

The wizard verifies the folder is readable and warns if it is mounted writable (it should not be — Trobar treats your library as read-only truth).

2. Pick a provider

A provider is where playlists and library niceties come from. One provider is active at a time.

Provider	What you get	What it needs
Filesystem	Library browsing + sync only, zero dependencies	Nothing — just the music folder
Roon	Playlists, live pairing status	A Roon Core on the LAN
Jellyfin	Playlists	Server URL + API key + username
Emby	Playlists	Server URL + API key + username
Plex	Playlists	Server URL + token
Lyrion Music Server	Playlists	Server URL (+ user/password if secured)
Subsonic	Playlists	Server URL + user + password (Navidrome, Gonic, Airsonic, …)
Music Assistant	Playlists, artist images where it has them	Server URL + long-lived token

Each has its own page under Providers, including the Roon pairing dance. You can switch provider later, through Change library source: it carries over the playlists the new provider also has, removes the old provider's other playlists and the artist-image cache, and shows what that touches before you confirm. Users, devices and your library survive.

Artist images are separate

Artist pictures are configured independently of the provider: set a free TheAudioDB API key in Administration and pictures come from there. Without a key, the active provider and any image sitting in the artist's own folder act as fallbacks. See API keys.

3. Listening history (optional)

An optional app-wide default Last.fm API key, used as a fallback for any user who hasn't connected their own account. Leave it blank to skip — every user can still connect their own Last.fm or ListenBrainz account later from their profile (ListenBrainz needs no key at all), and this can be set later too. See Suggestions.

Clicking Finish completes setup and starts the first library scan in the background, then takes you straight to the library — there's no separate "scan in progress" screen to wait on. Plan for a few minutes per 10k tracks on network storage; incremental rescans afterwards only touch changed files. More on scanning in Library & Selections.

Running it again

In AUTH_MODE=local, an admin can walk through the wizard again from Administration → Configuration → Maintenance → Run setup again: to move the music folder, re-enter the library source's connection details, or set the default Last.fm key. It starts from the current settings and saves nothing until Finish; Back to Administration leaves at any step without changing anything. Test connection tests the details as typed, without saving them. Changing to a different library source isn't done here: use Change library source. Finishing starts a library scan, as the first run does.