Common Errors

If you encounter issues during setup or operation of Remitium, check the categories below for potential causes.

1. Missing Application Key (APP_KEY)
  • •No application encryption key has been specified error
  • •Session or cookie related errors right after a fresh install
2. 500 Internal Server Error
  • •Blank white page instead of the expected site
  • •Generic "Whoops, something went wrong" screen
3. File & Folder Permission Issues
  • •"Permission denied" when writing to storage or bootstrap/cache
  • •Uploaded images or generated files fail to save
4. Server Requirement Failed
  • •Missing required PHP extensions
  • •Unsupported PHP or MySQL version
5. Database Connection Error
  • •Incorrect database credentials in the .env file
  • •Database host or port mismatch
6. Migration Failed
  • •Database user missing required privileges
  • •Insufficient server memory or execution timeout
7. Storage Symlink Not Working
  • •Uploaded images or logos return a 404
  • •public/storage link missing or broken after deployment
8. Mobile App Not Connecting to API
  • •API base URL not configured correctly in the app build
  • •Server SSL certificate or CORS misconfiguration
9. Push Notifications Not Working
  • •Firebase configuration missing or incorrect
  • •Invalid or expired notification keys
10. Payment Gateway Not Working
  • •Incorrect gateway API credentials
  • •Gateway disabled or misconfigured from the admin panel