Skip to content

Troubleshooting: Installation

Incomplete install

Symptom: INSTALLATION_INCOMPLETE. Run the installer verification and check for pending migrations.

Storage not writable

Symptom: STORAGE_NOT_WRITABLE. Diagnostics name the exact path. Correct the ownership/permissions for the panel user. Do not use chmod 777.

Cache not writable

Symptom: CACHE_NOT_WRITABLE. Correct the cache directory permissions.

Version mismatch

Symptom: FRONTEND_BACKEND_VERSION_MISMATCH. Rebuild the frontend assets after an upgrade.

Blueprint mismatch

Symptom: BLUEPRINT_VERSION_MISMATCH. Install the required Blueprint version.

Clock drift

Symptom: CLOCK_DRIFT_DETECTED. Synchronise the system clock (NTP).

Scheduler not running

Symptom: SCHEDULER_NOT_RUNNING. Verify the cron entry for schedule:run. Diagnostics distinguish this from a broken queue: if the queue fails, the scheduler check is skipped with the queue root reason.

Database / Redis

DATABASE_UNREACHABLE, DATABASE_SLOW, REDIS_UNREACHABLE, REDIS_READ_WRITE_FAILED. Check the service and its credentials.

Console gateway

See Troubleshooting: console and the console gateway setup.