FAQ

FAQ

Why Discord? Where is the admin password?

There is no password signup. Everyone signs in with Discord (identify). The admin is SOUNDDOCK_ADMIN_DISCORD_ID in .env, applied every time SoundDock starts. If that value is empty, nobody is administrator.

How do I find my Discord user ID?

Discord User Settings → Advanced → Developer Mode. Right-click your avatar → Copy User ID.

Sign-in fails or loops

• Redirect URL must match exactly: {SOUNDDOCK_PUBLIC_URL}/api/v1/auth/discord/callback (no trailing slash on the public URL).
• SOUNDDOCK_PUBLIC_URL must be the URL you type in the browser (scheme, host, port).
• Behind HTTPS or a reverse proxy, set SOUNDDOCK_COOKIE_SECURE=true and SOUNDDOCK_TRUSTED_PROXIES to the proxy CIDR.

Which image do I pull?

export SOUNDDOCK_IMAGE=ghcr.io/skila1/sounddock:latest

The package must be public, or you must docker login ghcr.io.

How do I update?

sudo bash install.sh update

If you use extras, start them again with --profile discord and/or --profile cloudflare, then check docker compose ps.

Where is my data?

/opt/sounddock/data and the Postgres volume. uninstall without --purge keeps them.

Can I have more than one administrator?

Set SOUNDDOCK_ADMIN_DISCORD_ID to a comma-separated list of user IDs and restart. If that list is non-empty, anyone not on it is not an administrator.

Remote Import vs playlist URLs

Remote Import is for direct media file URLs. Spotify, YouTube, and similar playlist or page links go under Connected Services / playlist import. SoundDock does not download those providers' audio.

Does the Discord bot play YouTube or Spotify?

No. It searches and streams your library.

Can I build a bot or another app against SoundDock?

Yes. See Integration. Start at /api/docs on your instance.

Health

• /healthz and /readyz on the server
• install.sh doctor checks Docker and http://127.0.0.1:8080/healthz

Uninstall

sudo bash install.sh uninstall          # keep data
sudo bash install.sh uninstall --purge  # delete /opt/sounddock and volumes