Koel
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
Variants
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
- Anyone use Koel? : r/selfhosted - Reddit (reddit)
- Koel v2.0.0 released! : r/selfhosted - Reddit (reddit)
- Funkwhale vs. Koel - Anyone have thoughts on the two? - Reddit (reddit)
- How do you make sure to get all prerequisites for Koel? - Reddit (reddit)
Collected 48 days ago - public community threads