selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

koel logo

Self-host koel

v9.15.0

Stream your own music library in the browser

ReleaseOpen SourceMIT
Updatedlast month
LanguagePHP
Setup difficultyModerate
MobileNative app
Stars
17 350
Port
8000 (HTTP interface served by the standalone binary (also the address of Laravel's development server))
Install with Linux
Koel's main library screenThe equalizer panelArtists browsing screenAudio visualizer while playingUser management screenEditing a song's metadataInterface with the Classic themeInterface with the Dawn theme

What is koel?

Koel is a self-hosted music streaming solution that scans your personal audio collection and serves it through a browser-based player, aimed at people who want a Spotify-like experience over their own files. It runs a Laravel API server with a Vue front end and covers playlists and smart playlists, favorites, an equalizer, visualizers, podcasts, internet radio, lossless playback and playback state synced across devices. Artist and album details, artwork and related videos can be pulled in automatically from outside metadata services, including scrobbling of listens, and the library is also exposed through the Subsonic and OpenSubsonic APIs so third-party clients can use it. People sign in with email and password, may enable two-factor authentication, and admins manage multiple users; the interface ships with several themes. Koel needs MySQL, MariaDB, PostgreSQL or SQLite behind any PHP-capable web server, and installs from a single-archive standalone build, a pre-compiled release archive with Composer, or the official Docker image. The community edition stays free and MIT-licensed, while the paid Koel Plus one-time purchase adds per-user libraries, collaboration, cloud storage drivers, SSO, proxy authentication, a media browser, white labeling, custom themes and the AI assistant.

Should you self-host koel?

koel scores 74/100 on selfhost.directory (how scoring works) and ranks #1 of 59 in Music Streaming. It has 17 350 GitHub stars, +73 in the last 30 days.

It shipped 22 stable releases in the past year. The latest, v9.15.0, came out on 28 September 2026. New versions land roughly every 4 days.

Setup is moderate: expect some configuration beyond a single command. It is MIT-licensed and written mostly in PHP.

Its closest alternative on selfhost.directory is Navidrome Music Server (80/100, 24 768 stars). It scores higher overall, so compare the two before you pick. See koel vs Navidrome Music Server side by side.

Features

  • AI AssistantKoel Plus (paid edition) feature.
  • Audio Visualizer
  • Cross-device playback synchronization
  • Equalizer
  • Favorites
  • Internet Radio
  • Lossless audio support
  • Metadata Editing
  • Music Streaming
  • Playlists
  • Podcast Support
  • Scrobbling
  • Smart Playlists
  • Subsonic API
  • ThemesCustom themes require the paid Koel Plus edition.

koel README

koel Frontend Unit Tests Code Quality OpenCollective OpenCollective

Showcase

Intro

Koel (also stylized as koel, with a lowercase k) is a free, open-source music streaming solution that turns your personal collection into a sleek, web-based listening experience.

How to install koel

Install koel with Linux

No Composer, Node, or system PHP needed on the host. SQLite by default for zero-setup operation.
Environment variables
DB_CONNECTION, MEDIA_PATH, APP_URL

tar -xzf koel-franken-v9.3.2-linux-x86_64.tar.gz cd koel-franken-v9.3.2-linux-x86_64 ./koel php-server --listen :8000

Single-archive distribution from koel/franken packaging FrankenPHP (Caddy + PHP runtime) with the compiled Koel application.

How to configure koel

  • APP_NAMEKoel
  • APP_ENVproduction
  • APP_DEBUGtrue
  • APP_URLhttp://localhostThe address people use to reach Koel, e.g. https://music.example.com. Links in emails, such as password resets and invitations, point here, so make sure it is correct.
  • TRUSTED_HOSTS(empty)A comma-separated list of hostnames allowed to access Koel. Requests for any other hostname are rejected. Prefix a hostname with *. to allow any of its subdomains. Leave empty to allow any hostname. Example: localhost,192.168.0.1,yourdomain.com,*.yourdomain.com

koel releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

More in Music Streaming

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…