---
title: "Upgrade MariaDB"
url: https://docs.corefinity.com/guides/sites/software-and-services/mariadb-version
type: guide
last_updated: 2026-11-13
feature: php-runtime
related:
  - https://docs.corefinity.com/api/reference/runtime/get-php-catalogue.md
  - https://docs.corefinity.com/api/reference/runtime/update-mariadb-version.md
  - https://docs.corefinity.com/api/reference/runtime/get-php-runtime.md
  - https://docs.corefinity.com/api/reference/runtime/copy-php-runtime.md
  - https://docs.corefinity.com/api/reference/runtime/list-php-runtime-history.md
  - https://docs.corefinity.com/api/reference/runtime/get-php-runtime-revision.md
  - https://docs.corefinity.com/mcp/tools/corestack_php_version_change.md
  - https://docs.corefinity.com/mcp/tools/corestack_mariadb_version_change.md
  - https://docs.corefinity.com/mcp/tools/corestack_runtime_get.md
  - https://docs.corefinity.com/mcp/tools/corestack_runtime_adopt.md
  - https://docs.corefinity.com/mcp/tools/corestack_php_runtime_get.md
  - https://docs.corefinity.com/mcp/tools/corestack_php_catalogue_get.md
---
# Upgrade MariaDB

Move a site's database to the next MariaDB release.

## Before you start

- You can open the site in **Managed Websites**. Anyone who can open a site can upgrade its database.
- Your application supports the release you are moving to. Upgrade a staging environment first.
- [Take a backup](/guides/sites/backups/snapshots) first: an upgrade cannot be undone, and MariaDB never moves back to an earlier release.

## Upgrade the database

1. **Open Software & services**

   Go to **Managed Websites**, choose the site, then **Software & services** under **Site settings**. Choose **Upgrade…** beside **Database**.

   _Screenshot: The Services card of a site. The Database row reads MariaDB 11.4, Upgrades only, one release at a time, with the Upgrade… button ringed._

2. **Check the release**

   The dialog offers the next release only. Later ones read **Upgrade one LTS release at a time**: upgrade again once this one has finished.

   _Screenshot: The Upgrade MariaDB dialog. MariaDB 11.4 is marked Current, MariaDB 11.8 is chosen and MariaDB 12.3 reads Upgrade one LTS release at a time. The button reads Upgrade to MariaDB 11.8._

3. **Upgrade**

   Choose **Upgrade to MariaDB 11.8**. The button names the release.

The upgrade takes about a minute to apply, plus up to 3 minutes before it starts. When it is done, **Database** under **Services** and the site header show the new release.

## If the upgrade is refused

| Message                                                                | What to do                                                           |
| ---------------------------------------------------------------------- | -------------------------------------------------------------------- |
| **Another change is in progress**                                      | Wait for the other change on the site to finish.                     |
| **A snapshot is being taken. Try again in a minute.**                  | Wait for the backup to finish.                                       |
| **The site is not running normally. Try again once it has recovered.** | Check **Health** on the site's **Overview**, then try again.         |
| **A previous upgrade has not finished. Contact support.**              | Raise a [support ticket](/guides/support/raise-and-follow-a-ticket). |

## Automate this

**API:** [Update a site's MariaDB version](https://docs.corefinity.com/api/reference/runtime/update-mariadb-version.md), scope `write`

```bash
curl -X PUT https://manage.corefinity.com/api/corestack/sites/1042/mariadb-version \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "11.8"
  }'
```

**MCP:** [`corestack_mariadb_version_change`](https://docs.corefinity.com/mcp/tools/corestack_mariadb_version_change.md), scope `write`

```json
{
  "name": "corestack_mariadb_version_change",
  "arguments": {
    "site_id": 4211,
    "to": "11.4"
  }
}
```

**Control Panel:** Managed Websites › your site › Site settings › Software & services ([https://manage.corefinity.com/go/php-runtime](https://manage.corefinity.com/go/php-runtime))

## Related

- [Backups](/guides/sites/backups/snapshots): Take a backup before a change.
- [Change PHP version](/guides/sites/software-and-services/php-version): Switch a site to another PHP version.
- [Application versions](/guides/sites/software-and-services/application-versions): See which release a site runs.
