Skip to content
KMD Agency Documentation

Troubleshooting the Installer

The installer redirects me back to the license step

Likely cause: your pre-database license verification session expired (it’s valid for 30 minutes) or was never completed.
Solution: enter your license key again — this is expected behavior, not an error, and doesn’t consume an extra activation.

“Could not reach the licensing server”

Likely cause: outbound HTTPS from your server is blocked, or a temporary network issue.
How to check: confirm your host allows outbound HTTPS connections (some restrictive shared-hosting firewalls block it by default).
Solution: wait and retry, or contact your host about outbound connectivity. This is reported distinctly from an invalid license — retrying costs you nothing.

Database connection test fails

Likely cause: incorrect host, database name, username, or password, or the database user lacks privileges on that database.
How to check: confirm the same credentials work from your hosting panel’s database tool directly.
Solution: re-enter the correct values. On most shared hosting, the database host is localhost, not a public hostname.

A requirement check fails and I can’t continue

Likely cause: a required PHP extension is disabled, or storage//bootstrap/cache/ aren’t writable by the web server.
Solution: enable the missing extension in your hosting panel’s PHP settings, or contact your host — see Server & Hosting Requirements for the exact list checked.

Blank page or 500 error during installation

How to check: your hosting panel’s PHP error log (not the browser) will usually show the real cause — most often a PHP version mismatch or a missing extension that the installer’s own check didn’t catch because it wasn’t reached yet.
When to contact support: if the error log doesn’t point to a clear PHP/server configuration issue.