# Koel

Koel is a self-hosted media applications app. Free, open-source, self-hosted music streaming server that turns a personal music collection into a fast, browser-based listening experience. It is open source and self-hosted, installable on Proxmox.

Canonical page: https://ourlocalhost.com/app/3777/koel

## Description

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: TrueNAS, Proxmox, Any server.

## Health score

82/100 (Excellent), based on 4 of 5 factors.
- Maintained: 100 (last commit 6 days ago)
- Popular: 85 (17,352 GitHub stars)
- Easy to install: 45 (3 install platforms, install notes)
- Security check: 80 (no serious findings, CI, tests, OpenSSF Scorecard 5.1/10)

## Links

- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=koel
- Official website: https://koel.dev/
- GitHub: https://github.com/koel/koel
- Documentation: https://docs.koel.dev

## 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.

## Alternatives

- 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.

---
Source: Our Local Host (https://ourlocalhost.com/app/3777/koel), the self-hosted and open-source app directory.
