RompMusic

Self-Hosting Guide

Run RompMusic on your own Debian server or VPS using Docker. You need:

  • Docker and Docker Compose
  • Music files (MP3, FLAC, M4A, OGG)
  • Optional: beets for organization and tagging

Quick Start

git clone https://github.com/rompmusic/rompmusic.git
cd rompmusic
cp .env.example .env
# Edit .env: set JWT_SECRET, MUSIC_PATH, DB credentials
docker-compose up -d

The server will be at port 8080. Create an admin user with the provided script, then scan your library from the web admin panel at /server.

Point the client app at your server URL (e.g. https://music.yourdomain.com) and log in.

← Back to home