troubleshooting.md

Shaark - Troubleshooting

Install and update

At first, read our installation guide.

Can't access the app once installed

Make sure the document root of your host points to the /public folder.

Error when updating with the shaark:update command

Sometimes you can have issues when upgrading, running the command a second time will generaly solve the problem.

Error with routing or views

Run these commands to get rid of common errors:

• php artisan optimize
• php artisan view:clear

JS or CSS is broken

Please check:

• Browser cache
• Git branch must be on master
• App URL must be configured in your .env

Images

Thumbnails are not correctly generated

Use the following command to regenerate images: php artisan media:regenerate

Search

No results with non-latin characters

By default, search is made using a "full-text" engine powered by Laravel Scout. It allows typing errors in your search (ex: helol instead of hello) and operators (ex: foo -bar search foo without bar). But it's not robust against non-latin search (ex: こんにちは, добрый день, etc).

Shaark provides a fallback to a classic SQL search using the LIKE operator. Set your preference in the settings section.

Archiving

Read our archiving guide.

Backup

Read our backup guide.

Dependencies

See dependencies used in this application.