This is installation documentation for installing Koel on Debian 8.

koel-installation-docs_debian8.md

Installation on Debian 8

This is installation documentation for installing Koel on Debian 8.

Install Dependancies

Most packages can be installed via apt-get.

user@debian:~/$ sudo apt-get install -y apache2 mysql-server php5 php5-mysql g++ git curl

Composer

More information about installing Composer can be found on its website here.

user@debian:~/$ sudo su
root@debian:/home/user# curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/bin --filename=composer
root@debian:/home/user# exit

Node

The node package in the default Debian repo is too old. There is more information about installing newer versions for Ubuntu and Debain here, but the following will be enough.

user@debian:~/$ sudo su
root@debian:/home/user# curl -sL https://deb.nodesource.com/setup_4.x | bash -
root@debian:/home/user# exit
user@debian:~/$ sudo apt-get install -y nodejs

Prepare the database

Create the database, a user for the service, and then grant permissions for that user.

user@debian:~/$ mysql -u root -p
Enter password:
mysql> CREATE DATABASE koel DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_general_ci;
mysql> CREATE USER 'koel-db-user'@'localhost' IDENTIFIED BY 'koel-pass';
mysql> GRANT ALL PRIVILEGES ON koel.* TO 'koel-db-user'@'localhost' WITH GRANT OPTION;
mysql> exit;

Prepare the project

user@debian:~/$ git clone https://github.com/phanan/koel.git
user@debian:~/$ cd koel
user@debian:~/koel$ npm install
user@debian:~/koel$ composer install

Edit the .env file with the necessary configuration changes. Below are example configuration changes made via sed.

user@debian:~/koel$ sed -i 's/ADMIN_EMAIL=/[email protected]/g' .env
user@debian:~/koel$ sed -i 's/ADMIN_NAME=/ADMIN_NAME=admin/g' .env
user@debian:~/koel$ sed -i 's/ADMIN_PASSWORD=/ADMIN_PASSWORD=admin-pass/g' .env
user@debian:~/koel$ sed -i 's/DB_CONNECTION=/DB_CONNECTION=mysql/g' .env
user@debian:~/koel$ sed -i 's/DB_HOST=/DB_HOST=127.0.0.1/g' .env
user@debian:~/koel$ sed -i 's/DB_DATABASE=homestead/DB_DATABASE=koel/g' .env
user@debian:~/koel$ sed -i 's/DB_USERNAME=homestead/DB_USERNAME=koel-db-user/g' .env
user@debian:~/koel$ sed -i 's/DB_PASSWORD=secret/DB_PASSWORD=koel-pass/g' .env

Now initialize the database and then start serving the site.

user@debian:~/koel$ php artisan koel:init
user@debian:~/koel$ php artisan serve

This will only allow connections from the localhost. If you would like to accept connections from other hosts, start the server by providing the 'host' option.

user@debian:~/koel$ php artisan serve --host 0.0.0.0

The site should be up now. Browes to it and sign in with the admin credentials we set in the .env file.
Username: [email protected]
Password: admin-pass

After many hours of frustration I was able to install on my digital ocean. There are definitely steps missing if you are coming from a vanilla install of Debian 8 x64. I still cant login but I see the login screen I am going to try and put together a better install guide soon I think I ran into every single problem that you might run into installing this software. If anyone knows why I can't login using the credentials I set in the .env file that would help a lot. Also before you run npm install run cp .env.example .env so you actually have an .env file and will not throw any errors during the install due to missing configurations.

Kohl is now using Laravel 5.4 and there are some additional changes need.

NPM need to be at least version 6.
curl -sL https://deb.nodesource.com/setup_6.x | bash -

Edited package.npm before doing npm install
"node-sass": "^3.7.0",

If running older version of mysql which jessie does. Edit app/Providers/AppServiceProvider.php before running php artisan koel:init to add these 2 lines

use Illuminate\Support\Facades\Schema;
Schema::defaultStringLength(191);

Like so

use Illuminate\Support\Facades\Schema;

class AppServiceProvider extends ServiceProvider
{
    /**
     * Bootstrap any application services.
     *
     * @return void
     */
    public function boot()
    {
        Schema::defaultStringLength(191);
        // Add some custom validation rules
        Validator::extend('path.valid', function ($attribute, $value, $parameters, $validator) {
            return is_dir($value) && is_readable($value);
        });
    }

After running php artisan koel:init to compile resources like gulp would do, run:
npm run build

Sorry, gist doesn't notify :( For those who come here: You don't need php artisan serve. A PHP-capable server (e.g. Apache) serving index.php will do just fine. Also, I've moved the docs here and added quite a few information – be sure to check it out!

The composer install also requires curl extension for php
sudo apt-get install php5-curl
For anyone who uses php 7:
sudo apt-get install php7.0-curl

$ npm install doesn't work (see: koel/koel#545), run $ yarn instead

Thanks @bplower for that, I followed your tutorial and made another guide installing the current koel master on a raspberry pi. see https://gist.github.com/jbheren/5c58b8488e0c47e6063cdcbe599c2ce1

Still having an issue with flac trancode not working.

Followed this and the official instructions, and I just get a blank gray page with a search box in the upper left.

Downloading binary from https://github.com/sass/node-sass/releases/download/v3.13.1/linux-x64-57_binding.node
Cannot download "https://github.com/sass/node-sass/releases/download/v3.13.1/linux-x64-57_binding.node":

HTTP error 404 Not Found

I've removed two unnecessarily negative comments from this thread. As such, I'd like to make a couple points:

1. Github doesn't show notification when a Gist receives a comment, even if you tag me in the message. Because of this, I haven't seen many of your comments and questions in a timely manner.
2. Please recognize the passage of time in relation to this guide. The last revision of this was written back in early 2016. That was about 2.5 years ago, and one major Debian release ago. In that timespan, the installation requirements for Koel have very likely changed. If you plan to use the guide for installation, expect to encounter problems.

I understand that unclear/incomplete/aged documentation can be frustrating to work with. Believe me when I say I've been there- that's in part why I wrote this guide in the first place. But that's what you sign up for when working with software. Though it looks like activity on this Gist is dying down, I'd like to request future commenters follow the Rust code of conduct and understand that this is a place for constructive communication only.

Hello, when I try to run : php artisan koel:init
I've this issue : PHP Warning: require(/usr/local/koel/bootstrap/../vendor/autoload.php): failed to open stream: No such file or directory in /usr/local/koel/bootstrap/autoload.php on line 17
PHP Fatal error: require(): Failed opening required '/usr/local/koel/bootstrap/../vendor/autoload.php' (include_path='.:/usr/share/php') in /usr/local/koel/bootstrap/autoload.php on line 17

I try : composer update -no--scripts, but still have issue.

Thanks