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

doc: add more troubleshooting hints

Browse source
This commit is contained in:
Phan An 2024-04-18 22:19:49 +02:00
parent 3a76d7c7e9
commit 1d7d3f44e1
2 changed files with 6 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
app/Console/Commands/InitCommand.php
View file

@ -70,7 +70,7 @@ class InitCommand extends Command
$this->components->error("Oops! Koel installation or upgrade didn't finish successfully.");
$this->components->error('Please check the error log at storage/logs/laravel.log and try again.');
$this->components->error('You can also visit ' . config('koel.misc.docs_url') . ' for other options.');
$this->components->error('For further troubleshooting, visit https://docs.koel.dev/troubleshooting.');
$this->components->error('😥 Sorry for this. You deserve better.');
return self::FAILURE;

6
docs/troubleshooting.md
View file

@ -20,9 +20,13 @@ If you receive an error, the first step is to take a look at `storage/logs/larav
Next, look at the browser console for any JavaScript errors.
While you're at it, check the network tab for any failed requests and try disabling the network cache.
Also, try clearing the cache and recompiling the front-end assets. Below are a couple of commands that might help in this area:
Also, try clearing the cache, reinstalling dependencies, and recompiling the front-end assets.
Below are a couple of commands that might help in this area:
```bash
# Remove Composer vendor/ directory and reinstall the packages
rm -rf vendor && composer install
# Clear node_modules, re-install, and re-build the front-end assets
rm -rf node_modules && yarn install && yarn build