Troubleshooting

Before Troubleshooting

Always check the following before proceeding with advanced troubleshooting:

Verify all server requirements are met
Check .env file configuration is correct
Ensure file permissions are properly set
Clear browser cache and cookies
Check error logs for detailed information

Common Issues

"SQLSTATE[HY000] [1045]" Error

Double-check your database credentials in the .env file. Ensure the database user has proper permissions.

"The stream or file could not be opened"

Check storage directory permissions. Run: chmod -R 755 storage && chmod -R 755 storage/app/public

Permission Denied Errors

Solution: Set correct permissions

chmod -R 755 storage 
chmod -R 755 bootstrap/cache

"Class not found" or "Method does not exist"

Clear caches: php artisan config:clear && php artisan cache:clear

White Screen or 500 Error

Enable debug mode temporarily in .env: APP_DEBUG=true to see detailed errors.

Essential Commands

Storage & Media Commands

Create Storage Link

Required for media file access (images, uploads, etc.)

php artisan storage:link

Creates symbolic link from storage/app/public to public/storage

Clear Storage Cache

php artisan storage:cache

Commands

# Set application key
php artisan key:generate

# Run database migrations
php artisan migrate

# Run database seeders only
php artisan db:seed --force

# Create storage symbolic link
php artisan storage:link

# Clear and cache
php artisan config:clear
php artisan cache:clear
php artisan config:cache
php artisan route:cache
php artisan view:cache

Email Issues

Emails not sending

SMTP configuration or queue issues

# Check .env mail settings
MAIL_MAILER=smtp
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
MAIL_USERNAME=your-username
MAIL_PASSWORD=your-password
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=your-email
MAIL_FROM_NAME="Eventix"

Still Need Help?

If you're still experiencing issues after trying these solutions, please check our FAQ or contact support.

Troubleshooting Guide

Common Issues & Solutions

Before Troubleshooting