Fixes

Follow these recommended steps to resolve common issues encountered during the setup or operation of Remitium.

Missing Application Key (APP_KEY)
  • Run php artisan key:generate on your server
  • Confirm APP_KEY is present and not empty in your .env file
  • Clear config cache with php artisan config:cache
500 Internal Server Error
  • Check storage/logs/laravel.log for the exact error message
  • Set APP_DEBUG=true temporarily to see the detailed error, then set it back to false
  • Ensure .env exists and required keys are filled in
File & Folder Permission Issues
  • Set correct ownership/permissions on storage and bootstrap/cache directories
  • Ensure the web server user has write access to those folders
  • Re-run the installer step if permissions were fixed mid-setup
Server Requirement Failed
  • Enable missing PHP extensions from your hosting control panel
  • Upgrade PHP to the required version (8.1+)
  • Restart the web server after making changes
Database Connection Error
  • Recheck database name, username, and password in .env
  • Confirm database host and port are correct
  • Ensure the database user has full privileges on the database
Migration Failed
  • Verify the database user has full privileges
  • Increase the PHP memory limit and max execution time
  • Re-run php artisan migrate after resolving the underlying issue
Storage Symlink Not Working
  • Run php artisan storage:link on your server
  • Confirm the public/storage symlink was created successfully
  • On shared hosting without symlink support, contact your host or copy files instead
Mobile App Not Connecting to API
  • Confirm the correct API base URL in the app configuration
  • Ensure a valid SSL certificate is installed on your domain
  • Check server firewall or CORS settings
Push Notifications Not Working
  • Recheck your Firebase project configuration
  • Upload the correct configuration files to the app and backend
  • Ensure the notification service is enabled in the admin panel
Payment Gateway Not Working
  • Verify gateway credentials from the admin panel
  • Enable the gateway before testing a transaction
  • Use test/sandbox credentials first if the gateway supports them
Additional Tips
  • • Always use a fresh database for installation
  • • Avoid running the installer multiple times
  • • Backup files and database before updates

If an issue persists after following these steps, pleasecontact supportwith detailed information and screenshots.