The application is updated by an administrator under Settings → Updates. Updates are downloaded from the provider's server. Most releases can be installed with one click (using the auto-installer, without FTP); some packages must be uploaded manually via FTP - the application will tell you which method applies to each release.

Updates require a valid licence (the same one that enables saving in the application). Without it, the list of versions cannot be downloaded.

Automatic checks and notifications

The application automatically checks for updates - you no longer need to open the settings each time:

  • after you log in (when you open the application),
  • periodically while the application remains open,
  • when you return to the browser tab (if some time has passed since the last check).

When a new release becomes available, the administrator will see a brief notification (“Update available - version X.Y.Z is ready to install”) with a Show button that opens Settings → Updates straight away. The notification appears once per version (so it will not bother you every time you open the application) - you will receive a new one for the next release.

New version indicator

Regardless of the notification, when a newer version is available, the administrator will see a red dot on the cog icon (⚙) in the top menu and, after opening the settings, the same dot next to the Updates tab. The dot disappears automatically once the latest version has been installed. Only administrators can see the indicator (and notification).

Checking available versions

  1. Click the cog icon (⚙) → Updates tab.

Development version. If the application is running in development mode (using code directly from the repository), update checks are disabled: there is no red dot or notification, and the tab clearly states that you are using a development version.

  1. Click Check for updates. You will see:
    • Installed version - the version running on the server,
    • Code version - the version of the application files,
    • Available versions - a list of newer releases, each with its Changelog.

Versions must be installed in order - only the button for the next version is active. Subsequent versions will become available after the previous one has been installed.

Downloading the package

  1. Click Download next to the first available version.
  2. A backup warning will appear - before updating, back up the database and the attachments folder (uploads/). Confirm to continue.
  3. The server will download the package and verify its checksum (SHA‑256). What happens next depends on the package type:
    • Package with an auto-installer - an Install button will appear (see below). You do not need to upload anything via FTP.
    • Package for manual upload - the browser will save the .zip file to your drive (if necessary, you can download it again using the Save package (.zip) button) and display the FTP instructions.

One-click installation (auto-installer)

For releases that support automatic installation (most updates), you do not need FTP:

  1. Once downloaded, click Install.
  2. A progress bar (“Installing…”) will appear, showing each stage: database migrations → copying files → finalisation.
  3. When the installation is complete, the button will change to Refresh application - click it to load the new version (you can also refresh the page using Ctrl/Cmd + Shift + R).

The installer does not modify your data - it skips includes/config.php, uploads/, storage/ and logs/, and automatically performs any required database migrations. It is still worth having a backup (as noted in the download warning).

Note: the progress bar only updates fully “live” once the installed version already includes this feature. When installing from an older version, the progress bar may update in stages.

Installation via FTP (packages without an auto-installer)

If the package does not support automatic installation, the application will display manual upload instructions:

  1. Back up the database and the uploads/ folder (if you have not already done so).
  2. Extract the downloaded .zip file.
  3. Connect to your hosting server via FTP and upload the contents of the package to the application directory, overwriting the existing files.
  4. DO NOT overwrite (keep your own copies):
    • includes/config.php - configuration and secrets,
    • uploads/ - attachments and avatars,
    • storage/ - working data,
    • logs/ - logs.
  5. Refresh the application in your browser (Ctrl/Cmd + Shift + R), then click Check for updates again to confirm the new version number.

If the release includes database changes, the instructions for that release (changelog / release notes) will specify any additional steps. If in doubt, restore the backup first and contact the provider.

Frequently asked questions

  • “Could not connect to the update server” - check your internet connection and make sure your licence is valid. The list of versions is only available to installations with a valid key.
  • “You have the latest version” - there is no release newer than the installed version.
  • The version did not change after uploading - make sure the files were uploaded to the correct directory and refresh the page without using the cache (Ctrl/Cmd + Shift + R).