Troubleshooting

When something goes wrong, Qorekit writes the details to storage/logs/laravel.log. Open it with your panel's file manager; the newest entries are at the end.

/status (such as https://crm.example.com/status) checks, without signing in, that the interface, the API and the database can talk to each other.

The site shows an error page (500)

• Write permissions. The web server must be able to write to storage/ and bootstrap/cache/. In the file manager, set those folders to 755 (or 775) and their files to 644.
• The PHP version. Qorekit needs PHP 8.3 or newer. Check Select PHP version or PHP settings in your panel; some hosts set the version per domain.
• A missing extension. The log names it. See requirements.

You see a list of files, a "403 Forbidden" page, or Qorekit's own files

The web server is not reading .htaccess. On Apache and LiteSpeed, ask your hosting provider to allow .htaccess files (AllowOverride All). With nginx, point the domain at Qorekit's public/ folder; see where to put the files.

The wizard says the database is not empty

Qorekit installs only into an empty database, so it never touches another program's tables. Create a new database, or enter a table prefix such as qk_ that no existing table uses.

The wizard says the database user may not create tables

The database user needs every privilege on its database. In DirectAdmin or cPanel, open the database's users and grant All privileges.

The browser says the site is not secure

• Make sure the address starts with https://. Turn on your panel's redirect from http to https.
• If the certificate was issued only a moment ago, close the tab and open the site again; the browser may still hold the old connection.
• If the installation recorded an http:// address, change APP_URL in .env to https://….

Pages sometimes answer "403 Forbidden" or "Too many attempts"

If the domain runs through a proxy such as Cloudflare (an orange cloud in its DNS), switch the record to DNS only. See before you start.

Nobody can sign in as an administrator

With SSH, create a new administrator with php artisan qorekit:create-admin. Without SSH, ask your hosting provider to run it, or another administrator to set a new password for you in Administration › Users.

"Too many attempts" after wrong passwords lifts by itself after a minute.

Uploads fail for larger files

Besides the field's own limit, PHP limits uploads with upload_max_filesize and post_max_size. Raise them in your panel's PHP settings.

Scheduled work does not run

See if it does not run.

After an update, the site does not open

1. Reload the page once; the first request applies database changes.
2. Look at storage/logs/laravel.log.
3. If it still does not work, go back to the previous version: with SSH, php artisan qorekit:update --roll-back. Without SSH, upload the previous release over the files, keeping .env and storage/.

Asking for help

Open an issue on GitHub. Say which version of Qorekit, PHP and database you run (the System page shows them), what you did, and what the log says. Remove passwords and personal data from anything you paste.