Files
borgmatic/docs/reference/configuration/data-sources/mariadb.md
T

2.2 KiB

title, eleventyNavigation
title eleventyNavigation
MariaDB
key parent
MariaDB 🗄️ Data sources

New in version 1.8.2 To backup MariaDB with borgmatic, use the mariadb_databases: hook instead of mysql_databases: as the MariaDB hook calls native MariaDB commands instead of the deprecated MySQL ones. For instance:

mariadb_databases:
    - name: comments

System databases

New in version 2.1.6 When dumping "all" databases, borgmatic excludes most data coming from MariaDB system databases, because much of it is populated on MariaDB startup and thus not restorable (or just unnecessary to backup).

The system data that borgmatic does include in these dumps are: users, roles, grants, user-defined functions, and remote servers—all from the mysql system database. This omits all other data from the mysql database, which includes index and table statistics, time zones, and installed server plugins. It also excludes the separate information_schema, performance_schema, and sys system databases. This is not currently configurable.

Within a Borg archive, you can find this data stored in a dump named mysql—the name of the system table this data comes from. And if you'd like to dump this data without having to dump "all" databases, then you can configure a database named mysql in your borgmatic configuration. For example:

mariadb_databases:
    - name: mysql

Even in this case though, only the subset of system data described above is included in the dump.

Prior to version 2.1.6 Dumps of "all" databases excluded system databases and all of their data. Additionally, explicitly dumping mysql was treated like any other database—and thus wasn't easily restorable.

Full configuration

{% include snippet/configuration/sample.md %}

{% include borgmatic/mariadb_databases.yaml %}