How to Install Koel on Debian

Koel is a web-based personal music streaming server that lets you organize, stream and share your music library with ease. In this tutorial, you will learn how to install and set up Koel on Debian.

Prerequisites

  1. A server running Debian 10 or later with root access.
  2. Docker installed on your server.

Step 1: Install Docker

Run the following command to install Docker:

sudo apt-get update
sudo apt-get install docker.io

Once the installation is complete, start the Docker service and set it to start on boot:

sudo systemctl start docker
sudo systemctl enable docker

Step 2: Install Koel

Create a new directory to host your Koel installation:

sudo mkdir /opt/koel
cd /opt/koel

Download the official Koel Docker Compose YAML file:

sudo curl -L https://koel.dev/get | sudo sh

Once the download is complete, run the following command to start the Koel Docker container:

sudo docker-compose up -d

Step 3: Set up Koel

Open your web browser and navigate to http://<your-server-ip>:8080. You should see the Koel login page.

Create a new admin account by clicking the "Sign up" button. Once you have successfully signed up, you can start adding your music library by clicking the "Add songs" button.

That's it! You have successfully installed and set up Koel on Debian.

Conclusion

We hope this tutorial has helped you install Koel on Debian. If you have any issues, please let us know in the comments below.

If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!

Alternatively, for the best virtual desktop, try Shells!