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:
services:
player:
image: ghcr.io/findmalek/lodesong:latest
restart: unless-stopped
environment:
NAVIDROME_URL: http://navidrome:4533
ports:
- "8080:8080"
volumes:
- player-data:/data
volumes:
player-data:docker compose up -dNo 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.