Koel

Free, open-source, self-hosted music streaming server that turns a personal music collection into a fast, browser-based listening experience.

  • Media Applications
  • Media Servers
  • Tools & Utilities
Free, open-source, self-hosted music streaming server that turns a personal music collection into a fast, browser-based listening experience.

Platform availability

Available on 3 of 10 platforms

  • Unraid (not listed)
  • TrueNAS
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

82/100 Excellent

Maintained
100last commit 6 days ago
Popular
8517,352 GitHub stars
Easy to install
453 install platforms, install notes
Light to run
No data
Security check
80no serious findings, CI, tests, OpenSSF Scorecard 5.1/10

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 12 days ago

GitHub stars
17,352
Open issues
16
Last commit
2026-11-15
Latest release
v9.15.0
License
MIT
Activity
declining

Checked 5 days ago - source: GitHub (koel/koel)

Resources & Compatibility

Requirements not published yet.

First-install notes

  • Getting started Koel has two parts: a Laravel API server and a Vue.js web client; deploy the server and open the client in a browser. source

Fetched 39 days ago - each note links to its source

Alternatives (7)

  • Clementine - Cross-platform free audio player and library organizer supporting local and internet radio playback, smart playlists, projectM visualizatio…
  • Fooyin - Fooyin is a music player built around customization.
  • Funkwhale - Open-source, self-hosted streaming platform supports Android, iOS, podcasts, uploads, sharing, no ads or tracking, federated across decentr…
  • Harmony Music - Streaming client for Android, Windows, and Linux supporting songs from YouTube and YouTube Music, with no ads, no login, offline play, qual…
  • Libre.fm - Libre.fm is a project to help you keep track of what music you like and share that, with your friends, discover new music, and meet new peo…
  • Navidrome - Navidrome is a modern self-hosted music server and streamer that organizes personal music libraries and provides Subsonic/Airsonic-compatib…
  • foobar2000 - Advanced audio player supporting MP3, FLAC, and more.

Checked 54 days ago - source: AlternativeTo

Common questions

Is there an official mobile app for Koel?

Yes, Koel Player is the official mobile app for Koel. It supports iOS and Android and avoids the limitations of the mobile web version.

Can I use existing Subsonic-compatible music clients with Koel?

Yes, Koel speaks the Subsonic and OpenSubsonic API. You can point any Subsonic-compatible client at your Koel library.

Do I need Koel Plus for proxy authentication or SSO?

Single sign-on and proxy authentication are listed as Koel Plus features in the documentation.

Where should I look when Koel is not behaving correctly?

The troubleshooting page covers common issues and solutions, debugging steps, log locations, and how to get help.

What maintenance should I plan for with a self-hosted Koel instance?

A self-hosting setup should keep Koel secure, up-to-date, and backed up.

Answers sourced from docs.koel.dev, docs.koel.dev, github.com, koel.dev, www.selfhostedninja.com

Community

Collected 48 days ago - public community threads