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 write down the URLs and credentials. The install wizard asks 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 (gemma4:12b works well; so do qwen3.5 and qwen3.6). Note the URL and model name. Prefer a hosted model? Anthropic, OpenAI, Google, OpenRouter, and DeepSeek all work. 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.