Analytics cookies only (Google Analytics, PostHog). No ad networks, no cross-site tracking. See our privacy policy.
A web-based personal music streaming server: scan a folder of audio files into a library, browse by artist, album and song, build playlists, and stream in the browser. It reads tags, shows album art, can transcode on the fly with ffmpeg, supports multiple users with an admin role, and can pull in artist and album info from Last.fm and Spotify. A Laravel application with a Vue front end; the official image bundles Apache and PHP and needs a separate MariaDB, MySQL or PostgreSQL database.
Runs on a VPS from $6/mo (Kamatera 2GB, 2 GB RAM) · prices checked Nov 2026
Fits home hardware (88 MB measured idle, RAM only): Raspberry Pi 4 (4 GB) (arm64 untested), Raspberry Pi 5 (8 GB) (arm64 untested), Repurposed laptop (8 GB), Intel N100 mini PC (16 GB), AMD Ryzen mini PC (32 GB).
Pick Koel when your music is a folder of files you own and you want a Spotify-style web player for it: scan the folder into a library, browse by artist, album and song, build playlists, stream in the browser with optional ffmpeg transcoding, and share it between several users with an admin role. It is MIT-licensed PHP (Laravel) with a Vue front end, and the official image bundles Apache and PHP but no database. Our snippet follows the koel/docker PostgreSQL compose file with the image pinned to 9.15.0, a generated database password and `APP_KEY`, and a one-off `koel:init` run to create the schema and the default admin account. We did not find an upstream RAM minimum, so our 512 MB floor is an estimate. Navidrome is the lighter single-binary music server with Subsonic-API clients; Jellyfin and Plex cover music alongside video, and Audiobookshelf is the spoken-word option.
Paid link — we earn a commission if you shop through it.
Run these commands on your server:
# Koel — music streaming server, next to PostgreSQL — based on the koel/docker compose files, pinned to 9.15.0
echo "DB_PASSWORD=$(openssl rand -hex 12)" > .env
echo "APP_KEY=base64:$(openssl rand -base64 32)" >> .env
cat > docker-compose.yml <<'EOF'
services:
koel:
image: phanan/koel:9.15.0
restart: unless-stopped
depends_on:
database:
condition: service_healthy
ports:
- 8080:80
environment:
DB_CONNECTION: pgsql
DB_HOST: database
DB_PORT: 5432
DB_USERNAME: koel
DB_PASSWORD: ${DB_PASSWORD}
DB_DATABASE: koel
APP_KEY: ${APP_KEY}
volumes:
- music:/music
- image_storage:/var/www/html/storage/app/public/images
- search_index:/var/www/html/storage/search-indexes
database:
image: postgres:17
restart: unless-stopped
environment:
POSTGRES_DB: koel
POSTGRES_USER: koel
POSTGRES_PASSWORD: ${DB_PASSWORD}
healthcheck:
test: ["CMD-SHELL", "pg_isready -U koel"]
interval: 3s
timeout: 3s
retries: 20
volumes:
- db:/var/lib/postgresql/data
volumes:
db:
music:
image_storage:
search_index:
EOF
docker compose up -d
timeout 180 bash -c 'until docker compose exec -T database pg_isready -q -U koel; do sleep 3; done'
docker compose exec -T --user www-data koel php artisan koel:init --no-assets --no-interaction
timeout 120 bash -c 'until curl -fsS http://localhost:8080/sw.js >/dev/null; do sleep 3; done'
# → http://SERVER_IP:8080 — sign in as admin@koel.dev with the default password KoelIsCool, change it at once, then set the media path to /musicThe koel/docker README and the project's init command flag these before you rely on it:
Koel used 88 MB of RAM at idle on GCP e2-standard-2 · Ubuntu 26.04 LTS · Docker 29.9.3 (first boot, measured Nov 2026). We list a minimum of 512 MB.
The Koel install snippet is marked verified on Ubuntu 26.04 (Nov 2026).