From 01e0e603d974e85ca816fddc616fee8c7e0bf5b8 Mon Sep 17 00:00:00 2001
From: siujamo <jamo.siu@gmail.com>
Date: Thu, 27 Aug 2026 11:11:16 +0800
Subject: [PATCH] feat(mariadb): add mariadb lts compose files

- add compose/mariadb/docker-compose.yaml for mariadb:lts
- expose port 3306 and persist data with mariadb_data volume
- add compose/mariadb/.env.example with default init vars
---
 compose/mariadb/.env.example        | 16 +++++++++++++
 compose/mariadb/docker-compose.yaml | 36 +++++++++++++++++++++++++++++
 2 files changed, 52 insertions(+)
 create mode 100644 compose/mariadb/.env.example
 create mode 100644 compose/mariadb/docker-compose.yaml

diff --git a/compose/mariadb/.env.example b/compose/mariadb/.env.example
new file mode 100644
index 0000000..bcbf78c
--- /dev/null
+++ b/compose/mariadb/.env.example
@@ -0,0 +1,16 @@
+# MariaDB — environment variables
+# Copy this file to .env and adjust values for your environment.
+
+# Root password.
+# The default is for local development only — always change for production.
+MARIADB_ROOT_PASSWORD=mariadb
+
+# Database created automatically on first start (default: mariadb).
+MARIADB_DATABASE=mariadb
+
+# Additional user created automatically on first start (default: mariadb).
+MARIADB_USER=mariadb
+
+# Password for the additional user.
+# The default is for local development only — always change for production.
+MARIADB_PASSWORD=mariadb
diff --git a/compose/mariadb/docker-compose.yaml b/compose/mariadb/docker-compose.yaml
new file mode 100644
index 0000000..c44248b
--- /dev/null
+++ b/compose/mariadb/docker-compose.yaml
@@ -0,0 +1,36 @@
+# Docker Compose file for MariaDB
+#
+# Usage:
+#   docker compose up -d
+#
+# Environment variables (see .env.example for details):
+#   MARIADB_ROOT_PASSWORD - Root password (default: mariadb)
+#   MARIADB_DATABASE      - Database created on first start (default: mariadb)
+#   MARIADB_USER          - Additional user created on first start (default: mariadb)
+#   MARIADB_PASSWORD      - Password for the additional user (default: mariadb)
+
+services:
+  mariadb:
+    # For available image tags, see https://hub.docker.com/_/mariadb
+    image: mariadb:lts
+    container_name: mariadb
+    environment:
+      # Root password.
+      # Default value is for local development only — change for production.
+      - MARIADB_ROOT_PASSWORD=${MARIADB_ROOT_PASSWORD:-mariadb}
+      # Database created automatically on first start.
+      - MARIADB_DATABASE=${MARIADB_DATABASE:-mariadb}
+      # Additional user created automatically on first start.
+      - MARIADB_USER=${MARIADB_USER:-mariadb}
+      # Password for the additional user.
+      # Default value is for local development only — change for production.
+      - MARIADB_PASSWORD=${MARIADB_PASSWORD:-mariadb}
+    ports:
+      # Map host port 3306 to container port 3306 (MariaDB default).
+      - "3306:3306"
+    volumes:
+      # Persist data beyond container lifetime.
+      - mariadb_data:/var/lib/mysql
+
+volumes:
+  mariadb_data: