VTunedocs

Getting started

First run#

The first successful startup creates a single-use owner setup URL and prints it to operator logs. Treat it as a credential.

Claim the owner account#

  1. Confirm the service is healthy only on loopback.
  2. Read the newest container logs from a private operator shell.
  3. Open the setup URL in the browser that holds your Discord session.
  4. Complete Discord OAuth and accept the instance terms.
  5. Confirm the dashboard identifies you as the instance owner.

If the URL expires or is lost before use, generate another from the pinned release:

docker compose -f compose.release.yaml run --rm vtune node dist/scripts/setup-token.js

Complete the instance#

  • Select an approved Discord server and voice channel.
  • Configure the DJ role and default volume.
  • Invite members deliberately; there is no public registration.
  • Create a group, upload a small test file, share it, and verify playback.
  • Confirm the data volume appears in your backup routine.

Acceptance check#

Test sign-in, upload conversion, a private track, a shared track, queue control, bot reconnect, and restore from a disposable backup before inviting a wider group.