Updating

Qorekit updates itself from Administration › System › Updates. Only administrators can update.

Checking for a new version

When an administrator opens the page, Qorekit looks for new versions, at most every six hours; Check now looks at once. When a newer version exists, the page shows its number, its release date and what is new in it.

Updating

1. Make a backup of the database first (see backups). An update changes the database, and going back to the old version does not undo those changes.
2. Choose Update to version and confirm.
3. Keep the page open. Qorekit downloads the package, checks it, and puts the new files in place. The site is unavailable for a few seconds.
4. The page reloads in the new version. The first request applies the changes to the database.

What is checked

Every package carries a SHA-256 checksum and an Ed25519 signature made with Qorekit's release key. Qorekit refuses a package whose signature does not match the keys it ships with, so nobody can push changed code to your installation by pretending to be the update server.

What is kept

Your data, .env, everything under storage/ (uploaded files, logs), and files that are not part of Qorekit are never touched.

Going back

The previous version is kept for a week. Go back to version puts its files back. Changes the update made to the database stay; they are made so that the older version works with them.

When updating is not possible

The page says what stops updating:

Message	What to do
PHP's zip extension is missing	Ask your hosting provider to turn on the zip extension
PHP's sodium extension is missing	Ask for the sodium extension; it checks signatures
This copy has no release keys	It was not installed from a release package; install one
PHP may not change Qorekit's folder	The web server needs write permission for the folder Qorekit is in
PHP may not write to storage/app	Give the web server write permission for storage/

You can always update by hand instead: make a backup, upload the new release over the old files, keeping .env and storage/, and open the site.

From the command line

php artisan qorekit:update            # update to the newest version
php artisan qorekit:update --check    # only check
php artisan qorekit:update --roll-back

Test versions

Test versions (such as 0.2.0-beta.1) are offered only to installations that run a test version themselves, or that ask for them with QOREKIT_UPDATE_PRERELEASES=true.