Self-hosted Discord music bot for YouTube, SoundCloud and internet radio.
1.0K
A self-hosted Discord music bot for YouTube, SoundCloud and internet radio, with queues, playlists and playback history. The image includes FFmpeg, yt-dlp and Node.js.
Source code · Deployment guide · Bot setup and configuration
Install Docker Engine with Compose 2.24+ and create and invite a Discord bot using the setup guide above. Download the deployment files:
mkdir melodix && cd melodix
curl -fsSLO https://raw.githubusercontent.com/keshon/melodix/main/docker/compose.yaml
curl -fsSL https://raw.githubusercontent.com/keshon/melodix/main/docker/.env.example -o .env
Edit .env: set DISCORD_TOKEN to your bot token and IMAGE_TAG=edge.
Then start the bot:
docker compose up -d
docker compose logs --tail=100 app
Public images do not require a Docker Hub login. Keep your Discord token private. The deployment needs no host ports, external Docker network or reverse proxy.
edge: builds from GitHub main.latest: the most recent stable release published by the container workflow.v*: exact Git release tags built by that workflow.sha-<commit>: a full commit SHA identifying a published build.Images support Linux amd64 and arm64. Both architectures are built and
smoke-tested before combined public tags are published.
The image runs as root (UID/GID 0:0) inside the container. Existing local
bind-mounted data needs no UID/GID ownership setup. The bot can modify files
in writable mounts as root; new files are normally root-owned on standard
Linux Docker. Mount only directories intended for the bot. Rootless Docker
and host security policies can still restrict access.
Compose stores application state in a named volume at /usr/project/data.
Keep the Compose project name unchanged to reuse that storage across updates.
See the deployment guide for host directories, backups, source builds and rollback instructions.
To update, select the intended IMAGE_TAG in .env, then run:
docker compose pull
docker compose up -d
docker compose logs --tail=100 app
Replacement briefly restarts the bot. Verify playback and persisted settings
in Discord afterward. Avoid docker compose down -v when retaining stored state.
Content type
Image
Digest
sha256:c0d8208c2…
Size
122 MB
Last updated
4 days ago
docker pull keshon/melodix