Skip to content

Extras

Jump to bottom
Skila edited this page Aug 21, 2026 · 9 revisions

Extras

Optional pieces are Docker Compose profiles. The installer can enable Cloudflare Tunnel. The Discord bot is started later from /opt/sounddock after you set the token in Admin. Redis and Meilisearch are in the repo compose file only.

Work from /opt/sounddock after install.

Discord bot

The bot plays from your SoundDock library. It does not play YouTube or Spotify.

After install:

  1. Paste the bot token in Admin → Discord.

  2. Add discord to COMPOSE_PROFILES in /opt/sounddock/.env, then:

    cd /opt/sounddock
docker compose up -d

  3. In the web UI, use Invite SoundDock Bot. Do not invent OAuth URLs by hand.

  4. In Discord, run /link and finish the challenge in the web UI. Never type SoundDock credentials into Discord.

Cloudflare Tunnel

Use this to publish SoundDock without opening a port on the host.

  1. Create a tunnel in Cloudflare Zero Trust and copy the token.

  2. During install, paste the token when asked, or later add to .env:

    CLOUDFLARE_TUNNEL_TOKEN=...
SD_PUBLIC_URL=https://your-hostname
SD_COOKIE_SECURE=true

  3. Start it by adding cloudflare to COMPOSE_PROFILES in /opt/sounddock/.env if needed, then:

    cd /opt/sounddock
docker compose up -d

  4. Point the tunnel at port 8080. Update the Discord OAuth redirect to https://your-hostname/api/v1/auth/discord/callback.

Music folder on the host

Default: /opt/sounddock/libraries, mounted read-only at /libraries.

Put files in that folder, then add a library in the UI that points at /libraries (or a subfolder). To change the host path, set SD_LIBRARY_HOST in /opt/sounddock/.env and run docker compose up -d from that directory.

Redis

Only in the repo docker-compose.yml:

# .env
SD_REDIS_URL=redis://redis:6379/0

docker compose --profile redis up -d

Meilisearch

Only in the repo docker-compose.yml:

# .env
SD_MEILISEARCH_URL=http://meilisearch:7700
SD_MEILISEARCH_KEY=a-long-random-key

docker compose --profile search up -d

Metrics

SD_METRICS_ENABLED=true
SD_METRICS_TOKEN=...

Scrape /metrics. Send Authorization: Bearer <token> when a token is set.

Discord bot and tunnel together

cd /opt/sounddock
docker compose --profile discord --profile cloudflare up -d

SoundDock

Clone this wiki locally