# Troubleshooting

**Blank page or "Application folder rpms not found"** - `rpms/` must sit next to, or above, the public web folder. See the installation guide, step 2.

**Requirements show FAIL for an extension** - cPanel > Select PHP Version > Extensions, tick it, reload.

**"Writable folder" FAIL** - File Manager > right-click the folder > Permissions > 755. If it stays FAIL, try 775. Do not use 777.

**Database "Access denied"** - the user must be added to the database (MySQL Databases > Add User To Database). Names include the cPanel prefix.

**Database "Unknown database"** - use the full prefixed name.

**Warning: database triggers not available** - the system works and the application still blocks edits to audit history, but the database does not enforce it. Ask the host to grant TRIGGER (or enable `log_bin_trust_function_creators`), then repeat install step 4. The Diagnostics warning stays until triggers exist.

**Pages other than the first give 404** - `.htaccess` was not copied (hidden file) or mod_rewrite is off. Show hidden files in File Manager and copy `.htaccess`. As a stop-gap, open addresses as `https://domain/index.php/login`.

**"Your session expired" on every form** - cookies blocked or `rpms/storage/sessions` not writable.

**Redirect loop after HTTPS switch** - set the site address in `rpms/storage/config.php` (`app.url`) to the https address.

**500 error** - the page shows a reference code. The matching line is in `rpms/storage/logs/app-YYYY-MM-DD.log` (no passwords or stack traces are written there).

**Locked out after failed sign-ins** - wait 15 minutes. An administrator can reset a password only through another administrator; if none can sign in, see UPDATE_AND_MAINTENANCE_GUIDE (emergency access).

**Installer says already installed** - `rpms/storage/installed.lock` exists. Remove it only if you intend to reinstall; it does not delete database tables.

**Cron does nothing** - Diagnostics > "Last scheduled run". Test the URL in a browser with the header set using a tool, or run the PHP command form. A 403 means the secret is wrong; 429 means a run is in progress or you are calling too often.
