Troubleshooting Common Issues

If you encounter hydration mismatch errors in the browser console, try these steps

Troubleshooting Common Issues

Hydration Mismatch Errors

If you encounter hydration mismatch errors in the browser console, try these steps:

Clear your browser cache and cookies

Rebuild the frontend assets:

pnpm i --frozen-lockfile && pnpm run ship

Clear the application cache:

php artisan view:clear
php artisan config:clear

Hydration mismatches often occur when the server-rendered content doesn't match the client-side rendered content. This can happen due to browser extensions or cached assets.

Permission Issues

If you encounter permission issues after updating:

Verify the ownership of your files matches your web server user

# If using NGINX or Apache (not on CentOS)
chown -R www-data:www-data /var/www/hydrodactyl/*

# If using NGINX on CentOS
chown -R nginx:nginx /var/www/hydrodactyl/*

# If using Apache on CentOS
chown -R apache:apache /var/www/hydrodactyl/*

Ensure storage and cache directories are writable:

chmod -R 755 storage/* bootstrap/cache/
chown -R www-data:www-data storage bootstrap/cache

Replace www-data with your web server user (nginx, apache) if different.

Troubleshooting Common Issues