The MariaDB Foundation ensures that there is not just one person or one company driving MariaDB/MySQL development. It is the custodian of the MariaDB code and guardian of the MariaDB community.

The MariaDB Foundation is the owner of the main MariaDB server project and owns mariadb.org. This ensures that the official MariaDB development tree will always be open for the MariaDB developer community.

Goals

That MariaDB be actively developed in the community and to:

• Increase adoption of MariaDB.

• Ensure sustainable high-quality efforts to build, test and distribute MariaDB.

• Ensure that community patches are reviewed and adopted.

• Guarantee a community voice and define development rules.

• Keep MariaDB compatible with MySQL.

• Maintain mariadb.org.

If you are using MariaDB in production and want to ensure that MariaDB is always actively developed, then you should sponsor or become a .

It's the MariaDB Foundation that ensures that all community patches, including MySQL source code, are merged into MariaDB. It also does the builds and QA of MariaDB and provides a lot of the .

We are very grateful to our who are making this work possible!

More information about the Foundation can be found on the .

_{This page is licensed: CC BY-SA / Gnu FDL}

Packages for Fedora Linux are included with our other packages available for download on.

We have also added YUM repositories to our online Repository Configuration Tool.

_{This page is licensed: CC BY-SA / Gnu FDL}

Latest Packages

Tarballs, source and binaries (Linux and Windows), and packages for some Linux distributions are available at mariadb.org/download.

We hope that interested community package maintainers will step forward, as others already have, to build packages for their distributions. We ask for strict adherence to your packaging system's best practices and invite you to create a bug report if our project impedes this in any way.

Instructions how to install the packages can be found here. See the documentation page for a list of which Linux distributions that include MariaDB.

Pre-Release Binaries

Binaries from our system at are available as containers on quay.io/mariadb-foundation/mariadb-devel:{major version}. Tags available are listed .

These haven't passed through a full release process; however changes there have been reviewed and are considered complete by the server developers. Its recommend to use these for testing.

Getting the Source

The download page contains the source for all released binaries. You can find the latest source code at

To retrieve the code, the source control software offers the path of least resistance. If you are unfamiliar with git, please refer to the for an understanding of version control with git.

For instructions on creating a local branch of MariaDB, see the page.

See the page for general instructions on compiling MariaDB from the source. The page has links to platform and distribution-specific information, including information on how we build the release packages.

Old Versions

Running the is generally the best choice. Note that there are long-term releases, maintained for five years, short-term releases, maintained for one year, and rolling releases. However, some organizations still use old or very old versions of MariaDB. An upgrade would probably require important changes in their applications, and sometimes they don't even have the sources of those applications.

contains all historical releases.

There are source and repositories there. To use repositories see the following link:

It is also possible to access Docker Official Images of MariaDB back to 5.5.40 when it became an official image ().

The Latest Packages

Tarballs, binaries (Linux, Solaris, and Windows), and packages for some Linux distributions are available at mariadb.com/downloads/ or mariadb.org/download/ (which also contains a PDF version of the MariaDB Server documentation).

We hope that interested community package maintainers will step forward, as others already have, to build packages for their distributions. We ask for strict adherence to your packaging system's best practices and invite you to create a bug report if our project impedes this in any way.

Instructions how to install the packages can be found here.

Distributions Which Include MariaDB

• Most distributions already include MariaDB. See .

Pre-Release Binaries

Binaries from our system (see also the page), are available at . They are not suitable for use in production systems but may be of use for debugging.

Once at the above URL you will need to click on the MariaDB tree you are interested in, and then the build. The build number corresponds to thetarbuildnum variable in Buildbot.

For example, if you were interested in the bsd9-64 build of the tree, revision 3497, the tarbuildnum is listed in the "Build Properties" table of the . In this case, the value is "2434".

Getting the Source

You can find all the source code at

To retrieve the code, the source control software offers the path of least resistance. If you are unfamiliar with git, please refer to the for an understanding of version control with git.

For instructions on creating a local branch of MariaDB, see the page.

See the page for general instructions on compiling MariaDB from the source. The page has links to platform and distribution-specific information, including information on how we build the release packages.

_{This page is licensed: CC BY-SA / Gnu FDL}

Checking out the Source with Git

The MariaDB source is hosted on GitHub: server. You can get a copy with:

If you want a source tarball for a specific released MariaDB version, you can find it at downloads.mariadb.org.

At any given time, developers is working on their own branches locally or on GitHub, with the main MariaDB branches receiving pushes less often.

The main MariaDB branches are:

Source repositories for the MariaDB Connectors are:

See also:

• page for instructions on how to use git to check out the source code and switch between the various branches.

The instructions on this page will help you download your own local branch of the MariaDB source code repository with the full revision history. If you want a tarball of the source without the revision history, see the .

Checking out the Source with Bazaar

If you simply want to browse the source code, you can do so from .

Prerequisites

You need for revision control.

Instructions

1. Prepare a directory to keep your MariaDB code in:

1. Get a clean local copy of the Maria repo with:

The above will give you the latest stable MariaDB version. If you want to get another release use lp:maria/5.2, lp:maria/5.3... For a complete list, go to and choose from the top menu on the page.

• Note: The initial branch operation can take a long time depending on the speed of your Internet connection and the load on launchpad. For this initial branch you need to download over a gigabyte of data.

• Note: Bzr is written in Python and very slow for initial checkout. Even on a fast connection, expect to need 1-2 GByte of RAM and possibly several CPU hours for the checkout.

1. If you get an error like:

then the version of bzr you are using is too old. Using or higher will fix this error.

1. If you have upgraded your bzr and are unable to successfully branch from launchpad, try using the source tree tarball (below) instead.

2. You can see the current history with:

1. If you are going to be hacking on the MariaDB source code. See the page for help.

2. If you just want to compile MariaDB at this point, see the page.

Source Tree Tarball

For those that have trouble branching MariaDB from Launchpad we have created a tarball of a complete repository of the MariaDB tree.

Prerequisites

You need to work with the repository.

Using the Source Tree Tarball

1. Download the mariadb-shared-repo.tgz file from .

• The file is 267MB, so the download may take a long time to complete depending on your Internet connection.

1. The .tgz file contains a .bzr directory. The parent directory of this .bzr directory is (or becomes) a shared repository containing the MariaDB source code. It is recommended to create a new directory for this, so the next step is to create a directory to house the repository. Call this directory anything you like ("maria", "mariadb", "my", "src", etc...). Once created, cd into the directory and untar the file. Here is an example using the name "mariadb" for the new directory, with the directory located in a directory called "src" in the home directory of the current user, and the mariadb-shared-repo.tgz file located in a directory named Downloads (also in the current user's home directory):

1. After the untar step you will have a bzr shared repository, but not a working tree. While in the shared repository directory, use thebzr branch command to branch the MariaDB trees you are interested in. For example:

• bzr branch lp:maria/5.2

• bzr branch lp:maria

1. Thanks to the repository, either of the above commands will complete very fast.

2. Before working with the code, make sure you pull down the latest version of the source code:

1. You can now use this source tree as if you had branched it from launchpad directly.

Alternate Bazaar Instructions

The following alternative instructions are what we have used for setting up repositories on our build machines in .

Shell Variables

To streamline later steps, we start by setting several shell variables. Set the values of the BZR and WORK_DIR variables to the appropriate values for your Linux distribution. The rest of the variables in this section should not need to be changed.

Binaries:

Directories

Source Checkout

Initialize your bzr working directories, if not done already:

Check out MariaDB sources:

Check out packaging sources (only for and below):

_{This page is licensed: CC BY-SA / Gnu FDL}

The proxy protocol allows proxy programs to relay the IP addresses of the clients to the server programs. It is important in the case of MariaDB, since IP information is actually a part of user identity.

How Proxy Protocol Works

As per the proxy protocol specification, the connecting client can prefix its first packet with a proxy protocol header. The server will parse the header and assume the client's IP address is the one set in the proxy header.

For example, if a client sends the proxy header (V1, text) which is "PROXY TCP4 192.168.0.1 192.168.0.11 56324 443\r\n", the server, after parsing, assumes the client's IP is 192.168.0.1

MariaDB server understands both Version 1 (text) and Version 2 (binary) of the proxy header.

If the protocol specified by the version 1 header is "UNKNOWN", the MariaDB server will treat the connection as if the proxy protocol was disabled. This can be used when a valid proxy protocol header is needed, but there is no client to proxy, for example, when a proxy does a health check.

Enabling Proxy Protocol in MariaDB Server

To enable use of the proxy protocol, it is necessary to specify subnetworks that are allowed to send proxy headers, using the server variable.

is either a comma-separated list of or IP addresses. One can also use 'localhost' in this list, which means Unix domain socket/named pipe/shared memory connections are allowed as well. Or proxy-protocol-networks can be set to *, meaning that proxy headers are allowed from any client.

Example in my.ini/my.cnf

allows IPv6 connections from local machine ::1, from IP addresses starting with 192.168, and from connections made with Unix domain sockets or named pipes.

Client-Side Support for Proxy Protocol

Since the functionality is suited only to very specific proxy-like programs, most client APIs do not provide support for sending proxy headers. One exception is version 3 or later. One can now use :

prior to or mysql_connect(), to send the header. In the call above, _header_ is the proxy header with the type void *, and _header_size_ is its size in bytes (type is size_t).

Example

Using Proxy Protocol with MariaDB MaxScale

If you want to use proxy protocol with MaxScale:

• Add the IP address of the MaxScale server to

• In maxscale.cnf, add the parameter for all configured servers

Once configured, MaxScale will proxy the credentials from the client to the server.

See Also

_{This page is licensed: CC BY-SA / Gnu FDL}

Find detailed descriptions in the Reference section:

This page lists projects which officially implement MariaDB's enhanced features, or state that they work with MariaDB. If you know of a project which officially supports MariaDB and it isn't listed here, please let us know in the comments.

Supports Enhanced MariaDB Features

• is a versatile and feature-rich IDE designed for MySQL and MariaDB professionals. It fully supports all individual features of MariaDB, such as support for Packages and Sequences, and other specificities.

• - The yii2-dynamic-ar extension uses MariaDB dynamic columns to add NoSQL-like documents to Yii 2 Framework's Active Record ORM.

• - supports .

• has special support for

Officially Supports MariaDB

• - Alfresco is for Enterprise Content Management and Business Process Management and it supports running with MariaDB Server.

• - Database documentation tool with rich-text fields and ERD creator.

See Also

_{This page is licensed: CC BY-SA / Gnu FDL}

Database connections are made using a connector (from an application) or a client (interactively or from scripts).

Clients and connectors listed here are supported under MariaDB Corporation Engineering Policies.

Clients and connectors listed here are compatible with:

• MariaDB database products (including Enterprise Server and MaxScale)

• MariaDB Community Server

MariaDB Connectors

MariaDB Connectors are available for many popular programming languages.

MariaDB Client

MariaDB Client can be used interactively or within scripts.

MariaDB Client is included with distributions of MariaDB database products.

Compatible third-party clients exist but are not listed here.

For additional information about MariaDB Client, see MariaDB Client.

Tools and Utilities

Tools and utilities listed here are included with distributions of MariaDB database products and make a client connection.

Business Intelligence (BI)

MariaDB database products are accessible from business intelligence (BI) platforms, including:

_{This page is: Copyright © 2025 MariaDB. All rights reserved.}

MariaDB is an open-source, multi-threaded, relational database management system, released under the (GPL). MariaDB's lead developer is Michael "Monty" Widenius, who is one of the founders of MySQL AB.

There are millions of installations of MariaDB worldwide, and thousands of downloads a day of MariaDB installation software. The success of MariaDB as a leading database is due not only to open source, but also its reliability, performance, and features.

Features

Many features contribute to MariaDB's standing as a database system. Its speed is one of its most prominent features. MariaDB is remarkably scalable, and is able to handle tens of thousands of tables and billions of rows of data. It can also manage small amounts of data quickly and smoothly, making it convenient for small businesses or personal projects.

Another feature that sets it apart from its predecessors is a particular focus on security. When critical security issues are discovered, our engineers immediately prepare and distribute a new release of MariaDB, as quickly as possible. The MariaDB team works closely with the to ensure all security issues are promptly reported and documented in sufficient detail. These details are typically released after the new release has been published.

MariaDB’s built-in functions include ones for manipulating and formatting text, business and statistical calculations, recording chronological information, as well as specialty features such ones related to GPS mapping.

Usage

We strive to develop a database system that works easily on the web and has one of the fastest connectors. Thanks to the fact that we use threads, we can handle much higher loads than other database systems. We have always striven to adapt to new hardware and to optimize the software for all commonly used systems and methods of deployment. Because we're continuously improving the software, we're able to provide a new release each month and a new version every year. That's an indication that things are happening and improving regularly.

In addition to web usage, MariaDB can be used for stand-alone applications ranging from enterprise transactional and analytical systems down to mobile devices, embedded with other software. MariaDB works in the cloud or on premise.

Due to its focus on performance and based on its threading model, MariaDB features the scale out technologies necessary for when your site or application experiences major spikes in traffic or rapid growth in business.

Security

With encryption that we've introduced in recent versions of MariaDB, you can be assured that your databases is secure — by default. Most other database systems don't have encryption by default.

Many organizations are leery about using commercial database software because they don't know for sure if the compiled code contains back-doors for accessing the data or some special way in which the software is using encryption that could allow a hacker to get at their data. Since MariaDB is open-source, governments and other organizations know that their databases are secure. Nothing is hidden.

Integration

The critical software in any database management system is its storage engine, which manages queries and interfaces between a user's SQL statements and the database's back-end storage. MariaDB offers several storage engines with different advantages. Some are transaction-safe storage engines that allow for rollback of data.

MariaDB also offers full integration with Galera cluster — an add-on for MariaDB for running multiple database servers for better performance and high availability. This is just one of many examples of how MariaDB integrates well with other software and systems. Such integration and MariaDB new encryption features have made it the premier database.

Version & Release Schedule

MariaDB is known for rapid and stable improvements. Each new release comes with speed and stability improvements, as well as new features. Current and development versions of MariaDB (and many previous versions) can be downloaded from the . There is also a yum repository for installing easily MariaDB and related software. Use the yum to configure your server.

See also the .

MariaDB makes updates to active releases about once a month. The provides a , which will give you information on when to expect the next release of MariaDB.

Learning MariaDB

If you're developing a career as a computer programmer, a web developer, or a similar role in computer technology, learning MariaDB will prove useful in your career. Many businesses develop and maintain custom software with MariaDB and the similar software. Additionally, many of the most popular web sites and software use MariaDB for their database — or they use another SQL database system that you can learn easily once you understand MariaDB.

It's highly likely that, for any job to which you apply or take as a database developer or administrator or as a web site developer, you is required to know or you isnefit from knowing MariaDB. Therefore, learning MariaDB is a good foundation for your career in computer technology. These documentation pages are your best resource for learning MariaDB in detail.

Related Pages

_{This page is licensed: CC BY-SA / Gnu FDL}

We rely on mirrors to distribute MariaDB to the world through the official download site at download. If you would like to volunteer to become a mirror, thank you! Getting you set up is easy.

How to Become a MariaDB Mirror

The only requirements for becoming a mirror are:

1. A willingness to mirror MariaDB

2. Mirroring is done using rsync

3. An https mirror should be utilised (http mirrors are not accepted any more)

4. Available bandwidth and disk space

Updating Notes

MariaDB will normally have no more than one release per series (10.4, 10.5, etc...) per month. There may be times when this is not the case (such as if a major bug is found), but those times are few.

Timing for release announcements is generally oriented to the U.S. Eastern time zone. So if your mirror only updates less frequently than every 6 hours, have it update after midnight, but before 06:00, U.S. Eastern Time.

With rsync, it is no problem to update several times per day, and doing so is encouraged.

rsync Information

The two primary rsync URLs for mirrors to use are:

USA:

Europe:

Here are suggested rsync commands for a mirror to use:

Be aware that when using the above rsync command, a "mariadb" directory will not be created. Instead, the contents of the mariadb module is rsynced into whatever local folder you specify. We suggest creating a "mariadb" folder for this.

It is also a good idea to test your rsync command before adding it to a cron job by adding the -v --dry-run flags to the command temporarily so you can see what it will do (without actually doing anything).

As of June 2025, running the above command will use around 750GB of disk space in total.

See the for details on what each of the arguments in the command above does.

Secondary rsync mirrors

We also have several secondary rsync mirrors you can pull from. In many instances pulling from the secondary mirror is faster than pulling from the primary rsync mirrors. Here they are, with the country they are located in. Simply replace the rsync URI in the example above with one from this list to use it.

The MariaDB Foundation mirrorbits system

The MariaDB Foundation maintains a mirror manager system (see: ). It is hosted by Hetzner in Germany, it is not available via rsync so you can't use it as a source for your mirror but you are encouraged to use it for your MariaDB installation and deployments. You can check the status of the service at https://mirror.mariadb.org/mirrorstats.

Getting Added to the Mirror List

Once you have initially mirrored the MariaDB release tree, please send an email to (mirror (at) mariadb [dot] org) with the following information:

1. The name of the company or organization sponsoring the mirror (so we can give credit where credit is due).

2. Contact name (and email address) for your mirror (so we know who to contact if there are any issues)

3. The general physical location (e.g. "Paris, France", "Hong Kong", or "Austin, Texas, USA") of the mirror (we use geolocation to try and send people to a mirror close to them).

4. The base public URL for the mirror (e.g. 'http://mirror.example.net/pub/mariadb'

Once we receive your email and verify your mirror is working we'll add you to the list of mirrors. Apologies in advance in case of slow responses - mirror updates are usually batched around release time.

Thank you for volunteering to mirror MariaDB!

Credits

The primary MariaDB mirrors have been generously provided by the (at rsync.osuosl.org) and (at mirror.netcologne.de).

Other mirrors (list not necessarily complete) are listed below and can be selected on the site:

Global (CDN)

• CICKU (Global - CloudFlare)

Australia

• AARNet (Brisbane)

• Digital Pacific (Sydney)

• Real World Group (Sydney)

Austria

• Alwyzon (Vienna)

• Digital Nova (Graz)

• Kumi Systems e.U (Vienna)

• next layer GmbH (Vienna)

Azerbaijan

• YER Hosting

Bulgaria

• Neterra Telecommunications

Canada

• ACORN-NS (Halifax)

Chile

• Insacom (Valparaíso)

China - 中国

• Dalian Neusoft University of Information / 大连东软信息学院 (Dalian)

• 清华大学 TUNA 协会 - Tsinghua University TUNA Association (Beijing)

• 中国科学技术大学, 合肥 - USTC (Hefei)

• eScience Center, Nanjing University (南京大学)

Czech Republic

• HOSTING90 systems (Prague)

• vpsFree.cz

Denmark

• dotsrc.org - Aalborg University (Aalborg)

• Group.one (Copenhagen)

Estonia

• xTom GmbH (Tallinn)

France

• IRCAM, Institut de recherche et coordination acoustique/musique (Paris)

• OVH (Roubaix)

Germany

• 23media (Frankfurt)

• AG DSN (Dresden)

• creoline GmbH (Frankfurt am Main)

• dogado GmbH (Leipzig)

Greece

• University of Crete / Computer Center (Crete, Heraklion)

Hong Kong

• 網匯在線有限公司 - Nethub Online Limited

• xTom GmbH (Hong Kong)

Hungary

• Budapest University of Technology and Economics (Budapest)

India

• Bharat Datacenter (New Delhi)

• Indian Institute Of Technology Delhi (New Delhi)

Indonesia

• Universitas Surabaya (Surabaya)

• Citrahost By Citranet (Jakarta)

• Heru Nugroho (Jakarta)

• Nevacloud (Jakarta)

Iran

• Kernel.ir (Tehran)

• Mobinhost (Tehran)

• Parsvds (Tehran)

Ireland

• HEAnet Ltd. (Dublin)

Israel

• SPD Hosting LTD (Rosh Haayin)

Italy

• EvoWise (Milan)

Japan

• 山形大学, 米沢市 - Yamagata University (Yonezawa)

• xTom GmbH (Osaka)

• KuronekoServer (Tokyo)

Kenya

• Liquid Telecom (Nairobi)

Lithuania

• UAB "Interneto Vizija" (Vilnius)

Moldova

• ihost.md (Chisinau)

• MangoHost.NET (Chisinau)

Morocco

• Marwan

The Netherlands

• bouwhuis.network (Amsterdam)

• NLUUG (Amsterdam)

• Serverion.com (Zoetermeer)

• Triple IT B.V.

Norway

• FjordOS (Oslo)

Philippines

• RISE

Poland

• ICM UW (Interdisciplinary Centre for Modelling, Warsaw University)

Portugal

• PTISP (Lisbon)

• WebHS (Lisbon)

• Universidade do Porto

Romania

• Chroot Network (Bucharest)

• nxtHost.com (Bucharest)

Russia

• docker.ru (Moscow)

• МИФИ - National Research Nuclear University "MEPhI" (Moscow)

• Truenetwork (Novosibirsk)

Singapore

• Daan van Gorkum

• National University of Singapore

South Korea

• zzunipark (Gwangju, South Korea)

Spain

• Raiola Networks (Madrid)

Switzerland

• MvA Internet Services GmbH (Zurich)

Taiwan

• OSSPlanet + Ubuntu-TW - Ubuntu 台灣在地推廣組

• Blendbyte (Taipei)

Thailand

• Khon Kaen University (Khon Kaen)

• THZHost.com (Bangkok)

Ukraine

• Distrohub (Kyiv)

• mirohost.net (Kyiv)

The United States of America (USA)

• Accretive Networks (Washington, Seattle)

• EvoWise (California, Los Angeles)

• EvoWise (New York, New York)

• Gigenet (Chicago, Illinois)

Uruguay

• Universidad de la República - Facultad de Derecho (Montevideo)

Vietnam

• BKNS.VN (Hanoi)

The MariaDB Archive

The distributed mirrors above only hold the most recent 3-4 releases of each MariaDB series (10.6, 10.11, etc...). If you need to access older MariaDB releases, there is an archive server that contains every MariaDB release. This server is available via the web at and via rsync at:

Mirroring the MariaDB Archive with rsync

If you want to mirror the archive mirror, please contact us at mirror@mariadb.org in advance.

To mirror the archive with rsync, something like the following will get you everything:

...or you can specify a specific release such as:

Warning, as of June 2025, the entire archive will use around 14 TB of disk space in total, and if you want to keep your mirror up to date (via cron routine for instance), please first compare the STATUS file before doing the rsync. This file is updated anytime a new content is added in the archive tree.

You can use something like the following:

We reserve the right to block IPs that continually rsync the archive mirror when no new content was added, since it uselessly overloads the archive server, which uses a slow remote storage system.

To get a listing of the top level items in the archive including a list of every MariaDB release, just do:

If you would like to become a full archive mirror of MariaDB and be listed here, just let us know via the . Thanks!

_{This page is licensed: CC BY-SA / Gnu FDL}