How to upgrade MariaDB to a newer version (11.4 or 11.8)
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
- Log in to the administrator panel (
https://<server>:2087). - Open Database Server in the menu (section Server). Version shows the MariaDB version now.
- Under Upgrade, choose the New version:
- MariaDB 11.4 — supported until 2029
- MariaDB 11.8 — supported until 2030
- Click Upgrade and confirm.
- 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
- Free space is checked.
- A safety copy of every database is saved in
/backup/mariadb/before-<version>-<date>.sql.gz. - MariaDB's own package repository is added and its packages are installed. Your settings are kept.
- The data is upgraded and the version is checked.
- 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.logon 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.
Thank you — this helps us improve the article.
Still stuck?
Ask the AI about your exact situation — it answers from this knowledge base — or contact us.
Related articles
- How to restart a service (web, mail, DNS, database)
Check the status of the web server, mail, DNS, database and other services in the Service Manager and restart one with a click.
- How to install operating system updates and security fixes
See which system packages wait for an update, install only the security fixes or everything, and restart the server when a new kernel needs it.
- How to open a root terminal in your browser (no SSH client)
Open a root shell on the server from the admin panel's Terminal page, how the one-time sign-in works and when the session closes.