Koel

A self-hosted music server with a rich web player for your own songs.

Replaces Spotify Apple Music Easy Free app

No server needed to start: Cloudgate can provide one. What happens when you click Deploy

Koel
Koel's dark web player showing the Sunday Morning playlist, with a cover made of four album covers, eight songs from different artists with album and length columns, Afterglow by Mira Okafor highlighted as playing, a left menu with All Songs, Albums, Artists, Genres, Podcasts, Radio, playlists, Settings, Upload and Users, and the player bar along the bottom
A playlist in Koel's web player, with your library, podcasts and radio in the menu. Captured by Cloudgate, with sample data
The Koel Albums grid with six albums, each showing its cover art, title and artist with Shuffle and Download links, while a song plays in the player bar at the bottom
Your albums as a grid, ready to shuffle or download. Captured by Cloudgate, with sample data
The Koel album page for Low Tide Radio by The Harbour Lights, from 2021 with 6 songs lasting 20 minutes 57 seconds, a large cover, a shuffle button, a star rating and Songs, Other Albums and Information tabs above the track list
An album page, with its tracks, other albums by the artist and album information. Captured by Cloudgate, with sample data

What is Koel?

Koel is a self-hosted music server: upload the songs you own and play them in a polished web player, with playlists, podcasts and radio.

Koel is a free, open-source, self-hosted music server that plays the music you own in a polished web player, much like Spotify or Apple Music but for your own files. You upload your MP3, FLAC and other songs straight in the web app, and Koel sorts them into albums, artists and genres, with playlists, smart playlists, podcasts and internet radio alongside.

A family, for example, could upload its ripped CD collection once, then let each person make their own playlists and listen from a laptop or phone browser, even offline for songs they keep in the browser. In the free edition everyone shares one library; separate libraries for each person, sharing and collaborative playlists come with the paid Koel Plus licence.

Koel's web player works on phones. The official Koel Player app for iPhone and Android is paid, and Koel also works with free Subsonic-compatible apps such as Tempo, Symfonium and substreamer. It can log your listening to Last.fm or ListenBrainz. Koel has no music catalogue: you bring your own music.

Cloudgate installs Koel on a server Cloudgate provides or one you connect, together with the database it needs, and gives it a secure web address. Sign in with the admin email you entered at setup and the password Cloudgate shows, then upload your music.

What you can do with Koel

  • Play your music in the browser Browse your songs by album, artist and genre, search the whole library and line up a queue in a Spotify-like web player.
  • Upload songs in the web app Drag files or whole folders onto Koel's Upload screen, and it adds them to your library and skips duplicates.
  • Playlists that fill themselves Make playlists and folders of playlists by hand, or set rules for smart playlists that update on their own.
  • Lossless files, light streams FLAC plays as it is, and each person can choose a lower quality for listening on mobile data.
  • Podcasts and internet radio Subscribe to podcasts by their feed address and add internet radio stations next to your music.
  • Listen offline in the browser Mark songs to keep in your browser so they play without a connection.
  • Equalizer, visualizers and themes Tune the sound with the equalizer, watch a visualizer and pick one of the built-in colour themes.
  • Accounts for the household The admin invites people by email; in the free edition everyone shares one music library, with their own private playlists and favourites.

Replaces Spotify and Apple Music

Koel does the same job as Spotify and Apple Music. Here is what changes when you switch.

What you gain
  • No monthly subscription and no ads
  • You hear your own files in the quality you chose, and nothing disappears when a licence ends
  • Podcasts, internet radio and your music in one web player
What is different
  • You bring the music; there is no catalogue, no recommendations and no editorial playlists
  • The official phone app, Koel Player, is paid; the free options are the web player on your phone or a Subsonic-compatible app
  • In the free edition everyone shares one library; separate libraries, sharing and collaborative playlists need the paid Koel Plus
  • Playlists can't be imported from Spotify or Apple Music, so you rebuild them in Koel

What happens when you click Deploy?

You do not need a server or any technical knowledge. Four steps, and Koel is running at its own web address.

  1. Step 1 Click Deploy and create your account

    Deploy takes you to Cloudgate. Create an account, or log in if you have one. Koel itself is free.

  2. Step 2 Choose a server

    No server? Get one from Cloudgate: pick a size and a country, and Cloudgate gets it ready. Already have one? Connect it instead.

  3. Step 3 Cloudgate sets up Koel

    It prepares the server, makes the passwords the app needs and starts it. There is nothing to install and nothing to write down.

  4. Step 4 Open your app and sign in

    Your app gets a free web address to start, without https. Add your own domain, like app.yourshop.com, and Cloudgate secures it with https for you.

Run Cloudgate yourself? Deploy from your own console

In your Cloudgate console, open Templates and choose Koel.

Questions

Is Koel free?

Yes. Koel is free, open-source software under the MIT licence, and you pay only for your server. An optional paid licence, Koel Plus, is a one-time purchase starting at €19.99 that adds a separate library for each person, music sharing, collaborative playlists, cloud storage, single sign-on, custom themes and an AI assistant; none of those are in the free edition.

Is Koel a good alternative to Spotify?

Yes, if you already own your music as files. Koel plays your own songs in a Spotify-like web player with playlists, podcasts and internet radio, and no subscription or ads, but it has no music catalogue or recommendations, so it plays only what you upload.

How do I sign in to Koel the first time?

Sign in with the admin email you entered when setting up Koel in Cloudgate and the password Cloudgate generated, which you find on the app's variables page. You can change the password in your Koel profile, then invite everyone else by email.

How do I add my music to Koel?

Upload it in the web app. Open the Upload screen in Koel's menu and drag in your music files or whole folders; Koel adds them to your library and spots songs it already has.

Is there a Koel app for iPhone or Android?

Yes, the official Koel Player app for iPhone and Android, but it is paid. Free options are Koel's web player in your phone's browser, or a Subsonic-compatible app such as Tempo, Symfonium or substreamer, which signs in with your email and the Subsonic key Koel gives each user.

Does each person get their own music library in Koel?

No, not in the free edition. Everyone you invite shares one music library, while their playlists, favourites and listening stats stay private to each account. A separate library for each person needs the paid Koel Plus licence.

Can I import my playlists from Spotify or Apple Music?

No, Koel has no playlist import. Upload the music files you own, then rebuild your playlists in Koel or let smart playlists collect songs by rules such as genre or year.

Do I need technical skills to run Koel?

No. Click Deploy, create your Cloudgate account and choose a server, and Cloudgate sets up Koel and gives it a web address. You use it in your browser like any other online tool.

Do I need my own server for Koel?

No. When you deploy Koel, hosted Cloudgate can provide a server. If you already rent one, you can connect it instead.

KoelFree app
Deploy Koel