SETUP · 01

Have these ready.

SUB/WAVE doesn't ship Navidrome or Ollama — it talks to yours. Get them running first if they aren't already, and note the URLs and credentials. The install wizard will ask for them.

THE CHECKLIST

Three things SUB/WAVE talks to.

Docker on the host.
Docker Compose runs the stack (two containers in dev, four in production — icecast and liquidsoap live together in a single broadcast container). The standalone subwave CLI is a single Bun-compiled binary with no runtime dependency — no Node needed unless you're hacking on the source (Development).
Navidrome — or any Subsonic-API server.
SUB/WAVE plays from your library, reachable from wherever the stack runs. Note the URL, username, and password — the wizard asks for all three. navidrome.org ↗
An LLM provider.
The DJ's words and track picks come from a language model. The homelab default is Ollama with a tool-capable model (qwen3.5, qwen3.6, or gemma4 all work) — note the URL and model name. Prefer a hosted model? Anthropic, OpenAI, Google, OpenRouter, and DeepSeek are all supported; you pick the provider and supply its key in the admin Settings UI after install, not during setup. ollama.com ↗

READY?

Pick an install path.

With Navidrome and an LLM reachable, head to Quick Start for the wizard, or Manual Install to run the commands yourself.