Common Installation Issues

Installation Troubleshooting

"Unable to locate file in Vite manifest"

This error occurs when Vite assets haven't been built. Run:

npx vite build

This must be done after any new SCSS or JS files are added to theme assets.

Storage Permission Errors

If you see "Permission denied" errors for storage or cache:

chmod -R 775 storage bootstrap/cache
chown -R www-data:www-data storage bootstrap/cache

Database Migration Errors

If migrations fail with foreign key errors, ensure you're using MySQL 8.0+ with InnoDB engine. Also check that add-on migrations run after core migrations.

Symlink Not Working (Windows)

On Windows, php artisan storage:link requires administrator privileges. Run your terminal as Administrator.

Images Not Loading

Run php artisan storage:link to create the public storage symlink. Also verify your APP_URL in .env is set correctly.