docs/getting-started.md
Getting started
You need a running Navidrome (or any OpenSubsonic server) and Docker. Setting up everything from scratch (Navidrome, uploads, AI playlists, a domain, Lyterion), or having a coding agent do it: self-hosting.
1. Run it
Next to an existing Navidrome, on the same Docker network:
| 1 | services: |
| 2 | player: |
| 3 | image: ghcr.io/findmalek/lodesong:latest |
| 4 | restart: unless-stopped |
| 5 | environment: |
| 6 | NAVIDROME_URL: http://navidrome:4533 |
| 7 | ports: |
| 8 | - "8080:8080" |
| 9 | volumes: |
| 10 | - player-data:/data |
| 11 | volumes: |
| 12 | player-data: |
| 1 | docker compose up -d |
No Navidrome yet? deploy/full-stack.compose.yaml runs both. Behind a domain:
deploy/README.md (Traefik, Caddy, nginx, Dokploy).
NAVIDROME_URL is the address this container uses, not your browser: usually the Navidrome service name on a
shared Docker network. Every other setting has a default (configuration).
2. Sign in
Open http://localhost:8080. Above the form, lodesong checks the server:
✓ navidrome 0.64.2 · 12 ms— all good. Sign in with any Navidrome account.✗ can't reach navidrome— the container can't reachNAVIDROME_URL. See troubleshooting.
Your password goes to the lodesong server only, which turns it into a Subsonic token, checks it with Navidrome and keeps it encrypted. The browser gets a session cookie and never sees the token (security).
3. First run
Right after the first sign-in in a browser:
- Make it yours: theme, how much music to keep for offline (the next songs download ahead so they start instantly), and whether to pick up where your phone left off.
- Three things worth knowing:
⌘Ksearches everything (even lyrics),?lists every shortcut, and the queue follows you between devices.