# Getting started (/docs/getting-started)

You need a running [Navidrome](https://www.navidrome.org) (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](/docs/self-hosting).

## 1. Run it

Next to an existing Navidrome, on the same Docker network:

```yaml
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:
```

```sh
docker compose up -d
```

No Navidrome yet? [`deploy/full-stack.compose.yaml`](https://github.com/FindMalek/lodesong/blob/main/docs/deploy/full-stack.compose.yaml) runs both. Behind a domain:
[deploy/README.md](/docs/deploy) (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](/docs/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 reach `NAVIDROME_URL`. See
  [troubleshooting](/docs/troubleshooting#cant-reach-navidrome).

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](/docs/security)).

## 3. First run

Right after the first sign-in in a browser:

1. **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.
2. **Three things worth knowing:** `⌘K` searches everything (even lyrics), `?` lists every shortcut, and the queue
   follows you between devices.

## 4. Next

- Learn the keyboard: press `?`, or read [shortcuts](/docs/shortcuts).
- Search tricks: [search](/docs/search).
- Lyrics everywhere: [lyrics](/docs/lyrics).
- Use your phone too: [sync](/docs/sync). Your other computers: [devices](/docs/devices).
- Mixes, prompt playlists and the recap: [mixes](/docs/mixes).
