Mirrors/koel
2
0
Fork 0
mirror of https://github.com/koel/koel synced 2024-09-20 06:11:53 +00:00
Code Issues Projects Releases Packages Wiki Activity

docs: add troubleshooting guide re:permissions

Browse source
This commit is contained in:
Phan An 2024-07-21 16:06:13 +03:00
parent 3572f29a68
commit 919607756e
1 changed files with 10 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

10
docs/troubleshooting.md
View file

@ -41,6 +41,16 @@ If you're still stuck, check below for a couple of common issues and their solut
## Common Issues
### You run into a permission issue
Solution: Make sure your web server has the necessary permissions to read/write to critical folders like `storage` and `bootstrap/cache`.
Also, remember to run artisan commands as your web server user (e.g. `www-data` or `nginx`), **never** as `root`, as these commands might create files that your web server user must have access to.
If you use the Docker installation, for example, run the scan command as the `www-data` user as follows:
```bash
docker exec --user www-data <container_name_for_koel> php artisan koel:scan
```
### You receive a `Class 'Pusher' not found` error
Solution: Add or set `BROADCAST_DRIVER=log` in your `.env` file. This will instruct Laravel to use `log` as the default broadcast driver instead.