[GH-ISSUE #505] Frequently Faced Problems Page - Wiki #355

Closed
opened 2026-02-26 02:32:56 +03:00 by kerem · 2 comments
Owner

Originally created by @challapradyumna on GitHub (Dec 21, 2016).
Original GitHub issue: https://github.com/koel/koel/issues/505

These are some of the problems I have faced while installing it from scratch on a new Linux machine.

If everyone can chip in over time this can become the single page for all problems.

Is the PHP version above 5.6?
php -v
Upgrade guide - https://www.digitalocean.com/community/tutorials/how-to-upgrade-to-php-7-on-ubuntu-14-04

composer require pusher/pusher-php-server (Pusher Class is not available)

npm install -g yarn ( Don't install Yarn package instead of NPM)

sudo ln -s /usr/bin/nodejs /usr/bin/node ( For the legacy error in node)

npm install --unsafe-perm ( cannot start in present wd )

Checked the node version?
If it is 0.xx install latest node from below commands.
curl -sL https://deb.nodesource.com/setup_6.x | sudo -E bash -
sudo apt-get install -y nodejs

Not able to login?

Is mod_rewrite enabled?
sudo a2enmod mod_rewrite

Is Allow override enabled?
File Path - /etc/apache2/sites-enabled/000-default.conf
<VirtualHost *:80>
ServerName koel.local

    XSendFilePath /data/Music        # Change to your music folder
    DocumentRoot /var/www/koel    # Change to the folder you installed koel in
    <Directory /var/www/koel>
            Options Indexes FollowSymLinks MultiViews
             AllowOverride All
            Require all granted
    </Directory>
Originally created by @challapradyumna on GitHub (Dec 21, 2016). Original GitHub issue: https://github.com/koel/koel/issues/505 These are some of the problems I have faced while installing it from scratch on a new Linux machine. If everyone can chip in over time this can become the single page for all problems. Is the PHP version above 5.6? php -v Upgrade guide - https://www.digitalocean.com/community/tutorials/how-to-upgrade-to-php-7-on-ubuntu-14-04 composer require pusher/pusher-php-server (Pusher Class is not available) npm install -g yarn ( Don't install Yarn package instead of NPM) sudo ln -s /usr/bin/nodejs /usr/bin/node ( For the legacy error in node) npm install --unsafe-perm ( cannot start in present wd ) Checked the node version? If it is 0.xx install latest node from below commands. curl -sL https://deb.nodesource.com/setup_6.x | sudo -E bash - sudo apt-get install -y nodejs Not able to login? Is mod_rewrite enabled? sudo a2enmod mod_rewrite Is Allow override enabled? File Path - /etc/apache2/sites-enabled/000-default.conf <VirtualHost *:80> ServerName koel.local XSendFilePath /data/Music # Change to your music folder DocumentRoot /var/www/koel # Change to the folder you installed koel in <Directory /var/www/koel> Options Indexes FollowSymLinks MultiViews AllowOverride All Require all granted </Directory> </VirtualHost>
kerem closed this issue 2026-02-26 02:32:56 +03:00
Author
Owner

@X-Ryl669 commented on GitHub (Jan 25, 2017):

If you're ok, I'll copy & rearrange this in my wiki page.

<!-- gh-comment-id:275106973 --> @X-Ryl669 commented on GitHub (Jan 25, 2017): If you're ok, I'll copy & rearrange this in my wiki page.
Author
Owner

@challapradyumna commented on GitHub (Jan 27, 2017):

@X-Ryl669 Sure , no problem. 👍

<!-- gh-comment-id:275778742 --> @challapradyumna commented on GitHub (Jan 27, 2017): @X-Ryl669 Sure , no problem. 👍
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/koel-koel#355
No description provided.