syllogiQuick Start
Run syllogi with Docker Compose and create your first sync.
Requirements
- A running Jellyfin or Navidrome server.
- A music library that includes your local music.
- Docker and Docker Compose.
- Optional: a Last.fm account (recommendations, charts) and/or a ListenBrainz account (recommendations).
Install
Copy the example compose file
cp docker-compose.example.yml docker-compose.ymlFill in the environment variables
See Configuration for the full list. At minimum you need the DATABASE_* variables, NEXT_PUBLIC_URL, AUTH_SECRET_KEY, and one music server.
Start the stack
docker compose up -dRegister your first account
Open the dashboard at http://localhost:8000.
The first account to register becomes admin automatically. Admins see the extra Users and Logs tabs. If you use Authentik SSO, the first OAuth login also becomes admin. See Users & Auth.
Add a music-server user, then a playlist
Create a music-server user under the Users tab (admin only), matching the exact Jellyfin/Navidrome username that will own playlists. If both Jellyfin and Navidrome are configured, set MUSIC_PROVIDER to disambiguate, refer to Configuration.
Then add a playlist, set a sync schedule, set up recommendations, and syllogi will take it from there.
Building from source
If you want to build the image locally instead of using the pre-built one, clone the repository:
git clone https://github.com/jeraldlyh/syllogi.git
cd syllogiThen use the development compose file, which builds from source with hot-reload:
docker compose up -d