Skip to content

MariaDB MariaDB

Description / nameInput element
Container Registry
Container Configuration Root Path
Timezone
User ID
Group ID
MariaDB Host Port
MariaDB /config Path

Build Status Last Commit

Drop-in replacement for MySQL built by the original authors — extends core MySQL functionality with alternate storage engines, server optimizations, and patches.
Port 3306
Registry ghcr.io/daemonless/mariadb
Daemonless daemonless/mariadb
Source MariaDB/server
Website mariadb.org

Version Tags

Tag Description Best For
10.11 / 10.11-pkg-latest FreeBSD Latest. Rolling package updates. Newest FreeBSD packages.
11.4 / 11.4-pkg-latest FreeBSD Latest. Rolling package updates. Newest FreeBSD packages.
11.8 / 11.8-pkg-latest FreeBSD Latest. Rolling package updates. Newest FreeBSD packages.
12.3 / 12.3-pkg-latest / latest / pkg / pkg-latest FreeBSD Latest. Rolling package updates. Newest FreeBSD packages.

Before deploying, ensure your host environment is ready. See the Quick Start Guide for host setup instructions, including the security model for host vs. container privileges.

Deployment

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
services:
  mariadb:
    image: "ghcr.io/daemonless/mariadb:latest"
    container_name: mariadb
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=UTC
      - MYSQL_ROOT_PASSWORD=changeme  # Root password (required on first run)
      - MYSQL_DATABASE=mydb  # Database to create on first run
      - MYSQL_USER=myuser  # User to create on first run
      - MYSQL_PASSWORD=mypassword  # Password for MYSQL_USER
    volumes:
      - "/path/to/containers/mariadb:/config"
    ports:
      - "3306:3306"
    restart: unless-stopped

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
# .env

DIRECTOR_PROJECT=mariadb
PUID=1000
PGID=1000
TZ=UTC
MYSQL_ROOT_PASSWORD=changeme
MYSQL_DATABASE=mydb
MYSQL_USER=myuser
MYSQL_PASSWORD=mypassword

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# appjail-director.yml

options:
  - virtualnet: ':<random> default'
  - nat:
services:
  mariadb:
    name: mariadb
    options:
      - container: 'boot args:--pull'
      - expose: '3306:3306 proto:tcp' \
    oci:
      user: root
      environment:
        - PUID: !ENV '${PUID}'
        - PGID: !ENV '${PGID}'
        - TZ: !ENV '${TZ}'
        - MYSQL_ROOT_PASSWORD: !ENV '${MYSQL_ROOT_PASSWORD}'
        - MYSQL_DATABASE: !ENV '${MYSQL_DATABASE}'
        - MYSQL_USER: !ENV '${MYSQL_USER}'
        - MYSQL_PASSWORD: !ENV '${MYSQL_PASSWORD}'
    volumes:
      - MARIADB_CONFIG_PATH: /config
volumes:
  MARIADB_CONFIG_PATH:
    device: '/path/to/containers/mariadb'

1
2
3
4
5
6
# Makejail

ARG tag=latest

OPTION overwrite=force
OPTION from=ghcr.io/daemonless/mariadb:${tag}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
podman run -d --name mariadb \
  -p 3306:3306 \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=UTC \
  -e MYSQL_ROOT_PASSWORD=changeme \
  -e MYSQL_DATABASE=mydb \
  -e MYSQL_USER=myuser \
  -e MYSQL_PASSWORD=mypassword \
  -v /path/to/containers/mariadb:/config \
  ghcr.io/daemonless/mariadb:latest

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
appjail oci run -Pd \
  -o overwrite=force \
  -o container="args:--pull" \
  -o virtualnet=":<random> default" \
  -o nat \
  -o expose="3306:3306 proto:tcp" \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=UTC \
  -e MYSQL_ROOT_PASSWORD=changeme \
  -e MYSQL_DATABASE=mydb \
  -e MYSQL_USER=myuser \
  -e MYSQL_PASSWORD=mypassword \
  -o fstab="/path/to/containers/mariadb /config <pseudofs>" \
  ghcr.io/daemonless/mariadb:latest mariadb

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
- name: Deploy mariadb
  containers.podman.podman_container:
    name: mariadb
    image: "ghcr.io/daemonless/mariadb:latest"
    state: started
    restart_policy: always
    env:
      PUID: "1000"
      PGID: "1000"
      TZ: "UTC"
      MYSQL_ROOT_PASSWORD: "changeme"
      MYSQL_DATABASE: "mydb"
      MYSQL_USER: "myuser"
      MYSQL_PASSWORD: "mypassword"
    ports:
      - "3306:3306"
    volumes:
      - "/path/to/containers/mariadb:/config"

Interactive Configuration

Parameters

Environment Variables

Variable Default Description
PUID 1000
PGID 1000
TZ Etc/UTC
MYSQL_ROOT_PASSWORD changeme Root password (required on first run)
MYSQL_DATABASE mydb Database to create on first run
MYSQL_USER myuser User to create on first run
MYSQL_PASSWORD mypassword Password for MYSQL_USER

Volumes

Path Description
/config MariaDB configuration and data

Ports

Port Protocol Description
3306 TCP MariaDB port

Implementation Details

  • Architectures: amd64
  • User: bsd (UID/GID set via PUID/PGID). Defaults to 1000:1000.
  • Base: Built on ghcr.io/daemonless/base (FreeBSD 15.1).

Need help? Join our Discord community.