How to upgrade MariaDB to a newer version (11.4 or 11.8)

For server administrators · Updated 2026-10-29

On this page
  1. Before you start
  2. Steps
  3. What happens during the upgrade
  4. Good to know
  5. Common questions

MariaDB runs the websites' MySQL databases, email sign-in and the control panel itself. Some applications need a newer version. You can upgrade to a newer long-term version from Database Server (section Server).

Before you start

  • Check that your applications support the new version.
  • Choose a quiet time: websites using databases, email sign-in and the panel pause for a minute or two.
  • Make sure there is free disk space for a full copy of all databases plus 2 GB. The upgrade stops before changing anything if there is not.

Steps

  1. Log in to the administrator panel (https://<server>:2087).
  2. Open Database Server in the menu (section Server). Version shows the MariaDB version now.
  3. Under Upgrade, choose the New version:
    • MariaDB 11.4 — supported until 2029
    • MariaDB 11.8 — supported until 2030
  4. Click Upgrade and confirm.
  5. The page shows the progress and refreshes every 10 seconds. At the end it shows the new version and where the safety copy is.

When the page says This is the newest long-term version offered., there is nothing newer to install.

What happens during the upgrade

  1. Free space is checked.
  2. A safety copy of every database is saved in /backup/mariadb/before-<version>-<date>.sql.gz.
  3. MariaDB's own package repository is added and its packages are installed. Your settings are kept.
  4. The data is upgraded and the version is checked.
  5. The mail server, FTP and the panel's agent reconnect to the new database server.

Good to know

  • There is no way back except restoring the safety copy. Older versions cannot be installed over a newer one.
  • The log of the upgrade is in /var/log/sahaab-mariadb-upgrade.log on the server.
  • If installing the packages fails, the databases are untouched and the message names the safety copy.

Common questions

Do I need to update my websites' database settings after the upgrade?

No. Database names, users and passwords stay the same.

The upgrade failed. Is my data lost?

No. The error message says what failed and where the safety copy is. Read the log, then check that MariaDB runs with systemctl status mariadb.

Was this article helpful?

Still stuck?

Ask the AI about your exact situation — it answers from this knowledge base — or contact us.