Configuration
MusicSeerr is configured through its web UI at Settings. All settings are persisted to the /config volume.
Lidarr Connection
Lidarr is the core integration - it manages your music library and handles album requests.
| Setting | Description |
|---|---|
| Lidarr URL | Your Lidarr instance URL (e.g. http://lidarr:8686) |
| API Key | Found in Lidarr → Settings → General |
| Quality Profile | Default quality profile for new artist additions |
| Metadata Profile | Controls which release types are monitored |
| Root Folder | Where Lidarr stores downloaded music |
After connecting, MusicSeerr syncs your library automatically. You can configure the sync frequency (manual, 5min, 10min, 30min, or 1hr).
Jellyfin Integration
Connect Jellyfin to enable local playback, recently played tracking, and library browsing.
| Setting | Description |
|---|---|
| Jellyfin URL | Your Jellyfin server URL |
| API Key | Generated in Jellyfin → Dashboard → API Keys |
| User ID | The Jellyfin user ID for personalised data |
ListenBrainz Integration
ListenBrainz powers personalised recommendations, trending data, and listening history.
| Setting | Description |
|---|---|
| Username | Your ListenBrainz username |
| User Token | Found at listenbrainz.org/settings |
YouTube Integration
YouTube integration enables album and track previews via embedded players.
| Setting | Description |
|---|---|
| API Key | A YouTube Data API v3 key from Google Cloud Console |
| Daily Quota | Maximum API searches per day (default: 80) |
Local Files
Mount your music directory to enable local file browsing and playback.
| Setting | Description |
|---|---|
| Music Path | Container-internal path to your music directory |
| Lidarr Root Path | Must match Lidarr’s root folder path for file mapping |
Advanced Settings
Advanced settings control caching behaviour, HTTP timeouts, and batch processing. These are available in Settings → Advanced and rarely need adjustment.
Key options include:
- Cache TTLs - Control how long library, search, and metadata data is cached
- HTTP Timeouts - Adjust connection and request timeouts for external services
- Batch Sizes - Control concurrency for artist image and album data fetching during sync
- Memory Cache - Set maximum entries and cleanup intervals
Environment Variables
MusicSeerr supports the following environment variables in your Docker configuration:
| Variable | Description | Default |
|---|---|---|
PUID | User ID for file permissions | 1000 |
PGID | Group ID for file permissions | 1000 |
Volume Mounts
| Path | Description |
|---|---|
/config | Persistent configuration and database storage |
/music | Music library directory (read-only recommended) |