# Install mariadb@12.3 with Homebrew, MacPorts, dnf, apk, chocolatey, Nix, pacman, zypper, apt, scoop, winget

Drop-in replacement for MySQL. Version 12.3.3 via Homebrew; verified 2026-10-13. Also installable with macports: sudo port install mariadb-12.3.

## Install

```sh
sudo av install brew:mariadb@12.3
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install mariadb@12.3
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install mariadb-12.3
```

  Evidence: MacPorts ports tree: databases/mariadb-12.3/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- dnf (92%):

```sh
sudo dnf install mariadb
```

  Evidence: Fedora Rawhide package metadata: mariadb from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/652278618dec9c023176a80c435a32a2c8154869fb0eb662c267a54df28d77d9-primary.xml.zst

- apk (92%):

```sh
sudo apk add mariadb
```

  Evidence: Alpine Linux edge package indexes: mariadb from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz

- Nix (92%):

```sh
nix profile install nixpkgs#mariadb
```

  Evidence: nixpkgs package indexes: mariadb from https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/top-level/all-packages.nix

- pacman (92%):

```sh
sudo pacman -S mariadb
```

  Evidence: Arch Linux sync databases: mariadb from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- zypper (92%):

```sh
sudo zypper install mariadb
```

  Evidence: openSUSE Tumbleweed package metadata: mariadb from https://download.opensuse.org/tumbleweed/repo/oss/repodata/d310d5a96106e1e8872a385adf98aaa23be9db5d80937a6717314e7e7f37715065c6c748ab7ccee6475d620b46979c0fe64235fc0c46988e17edf659578fcf31-primary.xml.zst

- Debian apt (92%):

```sh
sudo apt install libmariadb-dev
```

  Evidence: Debian stable package indexes: libmariadb-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

### Windows

- Chocolatey (92%):

```sh
choco install mariadb
```

  Evidence: Chocolatey community package catalog: mariadb from https://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','localsend'

- Scoop (92%):

```sh
scoop install main/mariadb
```

  Evidence: Scoop official bucket manifest trees: bucket/mariadb.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

- winget (92%):

```sh
winget install --id MariaDB.Server -e
```

  Evidence: Windows Package Manager source index: MariaDB.Server from https://cdn.winget.microsoft.com/cache/source.msix

## Package facts

- **Package key:** brew:mariadb@12.3
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/mariadb@12.3>
- **Version:** 12.3.3
- **Source summary:** Drop-in replacement for MySQL
- **Homepage:** <https://mariadb.org/>
- **Upstream docs:** <https://mariadb.org/>
- **License:** GPL-2.0-only
- **Source archive:** <https://archive.mariadb.org/mariadb-12.3.3/source/mariadb-12.3.3.tar.gz>
- **Last updated:** 2026-10-13T02:02:17Z
- **Generated:** 2026-11-04T12:20:42+00:00

## Dependencies

- groonga
- lz4
- lzo
- openssl@4
- pcre2
- xz
- zstd

## Build dependencies

- bison
- cmake
- fmt
- openjdk
- pkgconf

## Uses from macOS

- bzip2
- krb5
- libedit
- libxcrypt
- libxml2
- ncurses

## Install behavior

- Post-install hook: not defined
- Service: declared
- Caveats: A "/etc/my.cnf" from another install may interfere with a Homebrew-built server starting up correctly. MySQL is configured to only allow connections from localhost by default
- Bottle: available on arm64_golden_gate, arm64_linux, arm64_sequoia, arm64_tahoe, x86_64_linux

## Freshness

- Page generated: 2026-11-04
- Package-manager version: 12.3.3
- Package-manager updated: 2026-10-13
- Local data: ok
- Upstream repository: https://mariadb.org/
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

MariaDB Server is an open-source relational database management system derived from MySQL. It supports transactional, analytical, embedded, replication, and high-availability workloads while retaining extensive MySQL ecosystem compatibility.

### Project history

MariaDB began in 2009 when MySQL founder Michael “Monty” Widenius forked MySQL following Oracle's acquisition of Sun and concerns about future stewardship. It was named after Widenius's daughter Maria, continuing MySQL's family-name convention.

Many members of the original MySQL team joined the new project. In 2012, Michael Widenius, David Axmark, and Allan Larsson announced the nonprofit MariaDB Foundation to safeguard the interests of MariaDB users and developers as the server evolved beyond its initial MySQL-fork role.

### Adoption history

MariaDB retained broad compatibility with MySQL clients and application conventions, easing migration and allowing distributions and package managers to offer it as a MySQL-compatible server. The MariaDB Foundation identifies Wikipedia, WordPress.com, and Google among notable users and describes uses spanning transactional systems, analytics, and embedded deployments.

### How it is used

Install and initialize the server, run `mariadbd` as a service, and connect with the `mariadb` command-line client or a compatible connector. Server and client settings are read from ordered `my.cnf` files on Unix-like systems or `my.ini`/`my.cnf` files on Windows; `mariadbd --help --verbose` prints the exact paths for a particular build.

Client credentials may be placed in a restricted-permission `~/.my.cnf` option file, although prompting for a password or using an external secret store avoids keeping a plaintext password in a broadly readable file. MariaDB does not support MySQL's `.mylogin.cnf` credential format.

### Why package nerds care

MariaDB is one of the defining database forks in open-source package ecosystems. It preserves familiar MySQL protocols, tools, option-file conventions, and SQL workflows while being independently governed and GPLv2-licensed, making it a common distribution-level alternative to MySQL.

### Timeline

- 2009: Michael “Monty” Widenius and other original MySQL developers created and first released MariaDB.
- 2012: The nonprofit MariaDB Foundation was announced to safeguard the project's users, developers, and open development model.

### Related projects

- MySQL
- MariaDB Foundation
- Galera Cluster
- MariaDB Connector/C
- Percona Server

### Sources

- <https://github.com/MariaDB/server>
- <https://mariadb.com/docs/server/>
- <https://mariadb.org/en/>
- <https://mariadb.org/mariadb-foundation-to-safeguard-leading-open-source-database/>


## Security Notes

No matching local secret-handling manifest was found for mariadb@12.3. Package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: /etc/my.cnf, /etc/mysql/my.cnf, $MARIADB_HOME/my.cnf, $MYSQL_HOME/my.cnf, ~/.my.cnf
- Windows: System Windows Directory\my.ini, System Windows Directory\my.cnf, Windows Directory\my.ini, Windows Directory\my.cnf, C:\my.ini, C:\my.cnf, INSTALLDIR\my.ini, INSTALLDIR\my.cnf, INSTALLDIR\data\my.ini, INSTALLDIR\data\my.cnf, %MARIADB_HOME%\my.ini, %MARIADB_HOME%\my.cnf, %MYSQL_HOME%\my.ini, %MYSQL_HOME%\my.cnf

## Credential files

- Unix: ~/.my.cnf
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** mariadb@12.3
- **Version Scheme:** 0
- **Revision:** 1
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** yes
- **URL Keys:** stable

## Other Package-Manager Records

- MacPorts - mariadb-12.3: normalized package name match | MacPorts ports tree: databases/mariadb-12.3/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- dnf - mariadb - 12.3.2-100.fc45: package manager index match | Fedora Rawhide package metadata: mariadb from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/652278618dec9c023176a80c435a32a2c8154869fb0eb662c267a54df28d77d9-primary.xml.zst | Fast and robust SQL database server | https://mariadb.org
- dnf - mariadb-backup - 12.3.2-100.fc45: package manager index match | Fedora Rawhide package metadata: mariadb-backup from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/652278618dec9c023176a80c435a32a2c8154869fb0eb662c267a54df28d77d9-primary.xml.zst | Mariabackup tool for physical online backups | https://mariadb.org
- dnf - mariadb-client-utils - 12.3.2-100.fc45: package manager index match | Fedora Rawhide package metadata: mariadb-client-utils from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/652278618dec9c023176a80c435a32a2c8154869fb0eb662c267a54df28d77d9-primary.xml.zst | Non-essential client utilities for MariaDB/MySQL applications | https://mariadb.org
- dnf - mariadb-common - 12.3.2-100.fc45: package manager index match | Fedora Rawhide package metadata: mariadb-common from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/652278618dec9c023176a80c435a32a2c8154869fb0eb662c267a54df28d77d9-primary.xml.zst | Shared files required by server and client | https://mariadb.org
- dnf - mariadb-connect-engine - 12.3.2-100.fc45: package manager index match | Fedora Rawhide package metadata: mariadb-connect-engine from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/652278618dec9c023176a80c435a32a2c8154869fb0eb662c267a54df28d77d9-primary.xml.zst | CONNECT storage engine for MariaDB | https://mariadb.org
- dnf - mariadb-cracklib-password-check - 12.3.2-100.fc45: package manager index match | Fedora Rawhide package metadata: mariadb-cracklib-password-check from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/652278618dec9c023176a80c435a32a2c8154869fb0eb662c267a54df28d77d9-primary.xml.zst | Password strength checking plugin | https://mariadb.org
- dnf - mariadb-devel - 12.3.2-100.fc45: package manager index match | Fedora Rawhide package metadata: mariadb-devel from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/652278618dec9c023176a80c435a32a2c8154869fb0eb662c267a54df28d77d9-primary.xml.zst | Files for development of MariaDB/MySQL applications | https://mariadb.org
- dnf - mariadb-embedded - 12.3.2-100.fc45: package manager index match | Fedora Rawhide package metadata: mariadb-embedded from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/652278618dec9c023176a80c435a32a2c8154869fb0eb662c267a54df28d77d9-primary.xml.zst | MariaDB as an embeddable library | https://mariadb.org
- dnf - mariadb-embedded-devel - 12.3.2-100.fc45: package manager index match | Fedora Rawhide package metadata: mariadb-embedded-devel from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/652278618dec9c023176a80c435a32a2c8154869fb0eb662c267a54df28d77d9-primary.xml.zst | Development files for MariaDB as an embeddable library | https://mariadb.org
- dnf - mariadb-errmsg - 12.3.2-100.fc45: package manager index match | Fedora Rawhide package metadata: mariadb-errmsg from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/652278618dec9c023176a80c435a32a2c8154869fb0eb662c267a54df28d77d9-primary.xml.zst | Error messages files required by server and embedded | https://mariadb.org
- dnf - mariadb-gssapi-server - 12.3.2-100.fc45: package manager index match | Fedora Rawhide package metadata: mariadb-gssapi-server from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/652278618dec9c023176a80c435a32a2c8154869fb0eb662c267a54df28d77d9-primary.xml.zst | GSSAPI authentication plugin for server | https://mariadb.org
- dnf - mariadb-oqgraph-engine - 12.3.2-100.fc45: package manager index match | Fedora Rawhide package metadata: mariadb-oqgraph-engine from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/652278618dec9c023176a80c435a32a2c8154869fb0eb662c267a54df28d77d9-primary.xml.zst | Open Query GRAPH engine for MariaDB | https://mariadb.org
- dnf - mariadb-pam - 12.3.2-100.fc45: package manager index match | Fedora Rawhide package metadata: mariadb-pam from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/652278618dec9c023176a80c435a32a2c8154869fb0eb662c267a54df28d77d9-primary.xml.zst | PAM authentication plugin for the MariaDB server | https://mariadb.org
- dnf - mariadb-rocksdb-engine - 12.3.2-100.fc45: package manager index match | Fedora Rawhide package metadata: mariadb-rocksdb-engine from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/652278618dec9c023176a80c435a32a2c8154869fb0eb662c267a54df28d77d9-primary.xml.zst | RocksDB storage engine for MariaDB | https://mariadb.org
- dnf - mariadb-s3-engine - 12.3.2-100.fc45: package manager index match | Fedora Rawhide package metadata: mariadb-s3-engine from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/652278618dec9c023176a80c435a32a2c8154869fb0eb662c267a54df28d77d9-primary.xml.zst | S3 storage engine for MariaDB | https://mariadb.org


## Related links

- [Networking and protocol packages](https://pkg.so/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Database and data packages](https://pkg.so/database-data-tools/) - Matched database, SQL, migration, or data-store metadata.
- [Archive and compression packages](https://pkg.so/archive-compression-tools/) - Matched curated package taxonomy and local package facts.
- [mariadb@11.4](https://pkg.so/brew/mariadb-11-4/) - Choose MariaDB 11.4 when an application requires the established 11.x LTS baseline or when its mature deployment history outweighs 12.3's newer features.

  Sources: <https://mariadb.org/11-4-lts/> · <https://mariadb.org/about/>
- [mariadb@11.8](https://pkg.so/brew/mariadb-11-8/) - Choose MariaDB 11.8 when production or vendor certification is tied to the 2025 LTS and a 12.3 major upgrade has not yet been validated.

  Sources: <https://mariadb.org/11-8-lts-released/> · <https://mariadb.org/mariadb-server-12-3-lts-released/>
- [mysql@8.4](https://pkg.so/brew/mysql-8-4/) - Choose MySQL 8.4 when Oracle MySQL LTS compatibility or vendor certification is required; MariaDB remains protocol-compatible in many areas but is independently implemented.

  Sources: <https://dev.mysql.com/doc/refman/8.4/en/> · <https://mariadb.com/docs/release-notes/community-server/about/compatibility-and-differences/mariadb-vs-mysql-compatibility>

## Combined YAML source

View the package source record on GitHub. [combined/mariadb@12.3.yml](https://github.com/mxcl/pkgdb/blob/main/combined/mariadb@12.3.yml)


## Sources

- pkg.so package database
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
