VPS deployment

Target: any VPS with Docker + Docker Compose, ports 80/443 free (and 8000 if you want plain HTTP for very old stereos).

1. Lay out the bundle

ssh root@YOUR_VPS
mkdir -p /opt/airstudio/web/ai-radio && cd /opt/airstudio
# copy from the repo: docker-compose.yml, Dockerfile.streamer, icecast.xml, Caddyfile

2. Configure

cp .env.vps.example .env
$EDITOR .env            # set ICECAST_SOURCE_PASSWORD, station name, MQTT
$EDITOR icecast.xml     # set the 3 passwords + hostname
$EDITOR Caddyfile       # set your domain

ICECAST_SOURCE_PASSWORD in .env must match <source-password> in icecast.xml — the streamer authenticates with it.

3. Firewall

ufw allow 22,80,443/tcp
# optional plain-HTTP fallback for old stereos:
ufw allow 8000/tcp

4. Boot

docker compose up -d --build
docker compose ps        # icecast, radio-streamer, caddy all Up
docker compose logs -f radio-streamer

Expected streamer log: live on icecast:8000/ai-radio.mp3 then played <id>.mp3 lines as songs roll.

5. Verify

# direct icecast:
curl -sI http://localhost:8000/ai-radio.mp3 | head -1
# via caddy (after DNS + cert issuance):
curl -sI https://radio.example.com/ai-radio.mp3 | head -1

In a desktop player: open the URL — you should hear the shipped playlist looping. (Empty web root → streamer waits; run the shipper once first.)

6. Ship from the generator

On the generator machine:

SHIP_REMOTE_TARGET=root@YOUR_VPS:/opt/airstudio/web/ai-radio/ \
SHIP_SSH_KEY=~/.ssh/id_ed25519_vps \
LIBRARY_DIR=~/ai-radio/library \
go run ./cmd/shipper

New songs appear on air within one playlist lap.

Operations

Restart everything: docker compose restart
Update streamer code: docker compose build streamer && docker compose up -d streamer
Admin UI: http://<vps>:8000/admin/ (user admin, your admin password) — shows listeners, mount status, kick sources.
Logs: docker compose logs -f icecast radio-streamer caddy
MQTT check: mosquitto_sub -h BROKER -t airstudio/nowplaying -v

Troubleshooting

Symptom	Cause / fix
streamer: `icecast rejected source 401`	password mismatch between `.env` and `icecast.xml`
streamer: `no playable files`	shipper hasn't run; check `web/ai-radio/` contents
silence but stream "connected"	stale playlist pointing at missing mp3s — re-run shipper
caddy 502	icecast container down: `docker compose ps`
no HTTPS cert	DNS not pointing at this VPS yet; check `docker compose logs caddy`
stereo shows garbage titles	very old ID3v1-only player: titles come from ID3v1 — re-transcode (already written by shipper)

2.7 KiB Raw Blame History