Troubleshooting Guide

General Troubleshooting Tips

1. Check Requirements: Ensure your hosting environment meets the required specifications, including PHP and database versions, necessary PHP extensions, and other server requirements.
2. Check Logs: Logs provide detailed insights and error descriptions:
   • storage/logs/laravel.log
   • PHP Error log
   • Apache/Server log

Specific Issues

Error 500

Check the log: If you encounter a 500 error, check storage/logs/laravel.log for detailed error insights. If the log does not provide a clear answer, please send a support message.

500 Error Right After Uploading

If you get a 500 error message immediately after uploading the script instead of the installation screen, it is often because the PHP extension ext-intl (Internationalization) is not present. Ensure this extension is activated.

Display Folder Structure Instead of Installation Screen

If you see the directory tree instead of the installation interface, this can usually be due to:

1. Missing .htaccess: Some operating systems, like macOS, hide files beginning with a dot (.). If you cannot find the .htaccess file in the directory tree, it is probably hidden by your operating system. On Mac systems, this problem can be remedied by pressing Command + Shift + . (the dot key) to display hidden files.
2. Mod_rewrite Disabled: There is a chance that mod_rewrite is not enabled, meaning the .htaccess file is not parsed. While this is unusual because mod_rewrite is generally enabled by default, it is still worth checking.

Problems Uploading Images

Modify php.ini file: Problems uploading images can occur if the proc_open and proc_close functions are disabled in your PHP setup. This can be fixed as follows:

1. Locate the php.ini file: Determine the location of your php.ini file with the php --ini terminal command.
2. Edit the php.ini file: Open your php.ini file and look for the disable_functions directive. If it is missing, add it to the document.
3. Change the directive: Remove proc_open and proc_close from the disable_functions directive.

Numeric Value Out of Range Error

This error can occur in specific environments with strict numerical constraints. To resolve it:

Immediate Fixes:

1. Change Snowflake Setting for MySQL/MariaDB: If you're using MySQL or MariaDB, disable the Snowflake ID generation by setting SNOWFLAKE_ENABLED=false in your .env.blueprint file. After making this change, a reinstallation of the application is required. Reinstallation Guide.

2. Switch to SQLite: SQLite might offer a more streamlined solution for your setup. Switching to SQLite often resolves this issue. For installation instructions with SQLite, refer to the Reinstallation Guide. For more insights into why SQLite might be beneficial, read this detailed article.

Further Steps:

1. Check Database Configurations: Review your database configurations for settings that might contribute to high latency or other issues.
2. Consider Switching Hosting Provider: If the error persists, it might be worth considering a different hosting provider. Collaborate with your current provider's technical support to pinpoint the cause of the issue.