How to Install Koel on Windows 10

Koel is a free and open-source personal audio streaming platform that allows you to listen to your digital music collection from anywhere. In this tutorial, we will guide you through the process of installing Koel on Windows 10 using XAMPP.

Prerequisites

  • Windows 10
  • XAMPP with PHP 7.3 or higher
  • Composer

Step 1: Download and Install XAMPP

  • Download XAMPP from the official website.
  • Run the installer and follow the on-screen instructions to install XAMPP on your Windows machine.
  • Start the Apache and MySQL services using the XAMPP control panel.

Step 2: Download and Install Composer

  • Download Composer from the official website.
  • Install Composer by following the on-screen instructions.

Step 3: Install Koel

  1. Open the Command Prompt or Git Bash terminal.

  2. Create a new directory for Koel installation in the htdocs directory of XAMPP. For example:

    cd C:\xampp\htdocs
    mkdir koel
    cd koel
    
  3. Use the Composer to install Koel with dependencies by running the following command:

    composer create-project koel/koel --prefer-dist .
    
  4. After the installation completes, configure the .env file located in the root directory of Koel installation. Configure the database credentials as follows:

    DB_CONNECTION=mysql
    DB_HOST=127.0.0.1
    DB_PORT=3306
    DB_DATABASE=koel
    DB_USERNAME=root
    DB_PASSWORD=
    

    Save the changes and close the file.

  5. Generate the application key by running:

    php artisan key:generate
    
  6. Run the database migrations using the following command:

    php artisan migrate
    
  7. Finally, start the Koel server on the local machine by running the command:

    php artisan serve
    
  8. Open a web browser and go to http://localhost:8000 to access the Koel login page.

Conclusion

Congratulations! You've successfully installed the Koel on your Windows 10 machine. From now on, you can use Koel to stream your music collection from anywhere with an internet connection.