# Start to finish (/docs)

## What you'll have

- **Navidrome** serving your music folder, and **lodesong** in front of it, in one Docker Compose stack.
- **Lyterion** (optional) bringing a Spotify library over and keeping it in step every day.
- lodesong in every browser you use, as **one session**; the **Mac app** with the notch island; your **phone** on a
  Subsonic app against the same Navidrome.

Plan an hour for the first two steps, a bit more if you bring a Spotify library over.

## 1. Run the stack

Follow [self-hosting](/docs/self-hosting) top to bottom (a person or a coding agent can): it writes `compose.yaml` and
`.env`, starts Navidrome and lodesong, creates the first Navidrome account, and ends with a checklist. If you only want
to try it next to a Navidrome you already run, [getting started](/docs/getting-started) is shorter.

When it's done, `http://<machine>:8080` shows the sign-in page with `✓ navidrome` above it, and your albums after you
sign in.

## 2. Give it an address

Local only is fine at home. To use it from anywhere, put it behind a domain with HTTPS: [self-hosting, step
5](/docs/self-hosting#5-a-domain-with-https) for Caddy, [deploy](/docs/deploy) for Traefik, nginx and Dokploy. Whatever
proxy you use must pass WebSockets (the device picker and listen together use them). A tailnet (Tailscale) instead of a
public domain works too.

## 3. Your music

- **The folder** Navidrome reads is the library. Anything you add there shows up after Navidrome's next scan (hourly
  by default).
- **Uploads from the browser** (settings → library → upload) go into an inbox; point beets or Lyterion at it so files
  arrive tagged, with covers. [self-hosting, uploads](/docs/self-hosting#uploads)
- **Lyrics** come from your `.lrc` files and LRCLIB; lodesong can write the ones it finds next to your files so other
  apps get them too. [lyrics](/docs/lyrics)

## 4. Bring a Spotify library over (optional)

[Lyterion](/docs/lyterion) reads your Spotify library (liked songs, saved albums, followed artists, every playlist with its
order and cover) and places verified, tagged files into the same music folder. Set it up with its own guide, then connect
the two with one shared token; lodesong then shows each playlist's progress, and its library doctor hands bad files to
Lyterion to replace.

Once the first import is done, Lyterion's daily sync picks up what you like, save or add to playlists on Spotify, and
stars your likes in Navidrome, until you turn it off. What it couldn't verify waits in its review page.

## 5. Every device

- **Other browsers** of yours join one playback session automatically: press play anywhere and the rest become remotes.
  [devices](/docs/devices)
- **The Mac app**: download `lodesong-macos.zip` from the [latest release](https://github.com/FindMalek/lodesong/releases/latest),
  unzip, move it to Applications and open it with right-click → Open the first time (it isn't notarized). Give it your
  lodesong address. The song lives in the notch; it updates itself.
- **Your phone**: any Subsonic app (Arpeggi, Symfonium, Substreamer) against Navidrome's address and the same account.
  The queue hands off between phone and computer, and mixes show up there as playlists. [sync](/docs/sync)
- **Your terminal**: settings → sync → now playing in your terminal, for Claude Code or OpenCode.
  [devices](/docs/devices#now-playing-in-your-terminal)

## 6. Make it yours

- **Mixes** (daily mixes, discover weekly, the daylist) need a few days of listening first. [mixes](/docs/mixes)
- **Playlists from a prompt** and the mood mixes need a Groq API key in `.env` (`GROQ_API_KEY`). [mixes](/docs/mixes#playlists-from-a-prompt)
- **Shortcuts**: everything has a key; `?` shows them all. [shortcuts](/docs/shortcuts)
- **Your own tools**: settings → sync → api token, then the reference at `/api`. [api](/docs/api)

## 7. Keep it running

- **Updates**: `docker compose pull && docker compose up -d`, or pin a version and update on your schedule.
- **Backups**: the music folder, Navidrome's data volume (accounts, playlists, likes, play counts), lodesong's data
  volume (sessions, history, lyrics cache, synced settings) and `.env`. [self-hosting, keep it
  running](/docs/self-hosting#6-keep-it-running)
- **Something off**: [troubleshooting](/docs/troubleshooting). Every setting: [configuration](/docs/configuration).
