How to Install Koel on macOS

Koel is a simple, open-source music streaming platform that allows you to manage and listen to your music collection through a web interface.

In this tutorial, we will guide you on how to install Koel on macOS.

Prerequisites

Before we begin, please ensure that you have the following prerequisites installed on your system:

  • Homebrew package manager
  • PHP 7.4 or higher with the following extensions enabled: mbstring, zip, pdo, xml, curl, gd
  • NPM
  • Composer

Step 1: Install Dependencies

To install the required dependencies, open your terminal and run the following command:

brew install php composer npm

Next, install the required PHP extensions by running the following commands:

brew install [email protected]
brew install [email protected] [email protected] [email protected] [email protected] [email protected] [email protected]

Step 2: Download and Install Koel

Next, download Koel by running the following command:

git clone https://github.com/koel/koel.git

Now, navigate to the downloaded directory and install Koel’s dependencies by running the following commands:

cd koel
composer install
npm install && npm run prod

Step 3: Configure Koel

To configure Koel, copy the .env.example file to .env by running the following command:

cp .env.example .env

Next, generate a new application key and configure your database settings by running the following commands:

php artisan key:generate

Run the database migrations to create the necessary tables in the database:

php artisan migrate:fresh --seed

Step 4: Start Koel

To start Koel, run the following command:

php artisan serve

This will start the development server. You can access Koel at http://localhost:8000 in your web browser.

Conclusion

In this tutorial, we have shown you how to install Koel on macOS. You can now manage and listen to your music collection via the Koel web interface.