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.
ON THE HOST
Docker and Node.
- Docker + Compose plugin — the stack ships as four containers in dev, five in production.
- Node 20+ — only for the
npm run setupwizard and the web dev server. A production deploy can run without it. - (Optional) ffmpeg — used by
scripts/setup.shto render the emergency fallback and studio-bed audio.
THE MUSIC LIBRARY
A Subsonic-API server.
SUB/WAVE plays from a Navidrome library — or any server that speaks the Subsonic API — reachable from wherever the stack runs. Note the URL, username, and password; the wizard asks for all three.
THE DJ'S BRAIN
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 — qwen2.5:7b, llama3.1:8b, or nemotron all work. Note the URL and model name.
Prefer a hosted model? SUB/WAVE also supports Anthropic, OpenAI, Google, OpenRouter, and DeepSeek. You pick the provider in the admin Settings UI after install and supply the API key there — not during setup.
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.