From 7385e53a428ea54f364ec2a44927ef967c889076 Mon Sep 17 00:00:00 2001
From: Fabrizio Balliano <fabrizio.balliano@gmail.com>
Date: Mon, 20 Jul 2026 16:20:52 +0100
Subject: [PATCH] Add Maho environment type

---
 CHANGELOG.md                       |  3 +++
 commands/env-init.help             |  4 ++++
 environments/maho/db.base.yml      | 12 ++++++++++++
 environments/maho/init.env         | 27 +++++++++++++++++++++++++++
 environments/maho/maho.base.yml    | 13 +++++++++++++
 environments/maho/maho.darwin.yml  | 11 +++++++++++
 environments/maho/maho.mutagen.yml | 26 ++++++++++++++++++++++++++
 7 files changed, 96 insertions(+)
 create mode 100644 environments/maho/db.base.yml
 create mode 100644 environments/maho/init.env
 create mode 100644 environments/maho/maho.base.yml
 create mode 100644 environments/maho/maho.darwin.yml
 create mode 100644 environments/maho/maho.mutagen.yml

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 696f075d..c08da4e7 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,9 @@
 **Big Changes:**
 * Traefik has been updated from v2 to v3.  For compatibility, we have kept the v2 rule engine as the default.  It is possible to opt-in to v3 rule syntax on a per-router basis.
 
+**Enhancements:**
+* Added Maho environment type ([#941](https://github.com/wardenenv/warden/pull/941) by @fballiano)
+
 **Security Fixes:**
 * Fix arbitrary command execution via project `.env` files. The previous loader used `eval "$(grep ...)"` against any project's `.env`, allowing shell metacharacters (e.g. `$(...)` or backticks) inside `WARDEN_*`, `TRAEFIK_*` or `PHP_*` values to execute on the developer's host whenever `warden env *` was run. Replaced with a strict KEY=VALUE parser that validates identifiers and never evaluates values. (by @lbajsarowicz)
 
diff --git a/commands/env-init.help b/commands/env-init.help
index 255a45fb..18d7bd88 100755
--- a/commands/env-init.help
+++ b/commands/env-init.help
@@ -29,6 +29,10 @@ WARDEN_USAGE=$(cat <<EOF
   magento1            Nginx, php-fpm, db (mariadb), and redis services
                       pre-configured for running Magento 1
 
+  maho                Nginx, php-fpm, and db (mariadb) services pre-configured
+                      for running Maho; no redis, varnish or elasticsearch as
+                      Maho requires none of them
+
   symfony             Nginx, php-fpm, db (mariadb), and redis services
                       pre-configured for running Symfony 4+
                       Due to the fact that Symfony uses '.env' file too,
diff --git a/environments/maho/db.base.yml b/environments/maho/db.base.yml
new file mode 100644
index 00000000..ac60af2c
--- /dev/null
+++ b/environments/maho/db.base.yml
@@ -0,0 +1,12 @@
+services:
+  db:
+    environment:
+      - MYSQL_ROOT_PASSWORD=${MYSQL_ROOT_PASSWORD:-maho}
+      - MYSQL_DATABASE=${MYSQL_DATABASE:-maho}
+      - MYSQL_USER=${MYSQL_USER:-maho}
+      - MYSQL_PASSWORD=${MYSQL_PASSWORD:-maho}
+    command:
+      - mysqld
+      - --max_allowed_packet=1024M
+      - --explicit_defaults_for_timestamp=on
+      - --transaction-isolation=READ-COMMITTED
diff --git a/environments/maho/init.env b/environments/maho/init.env
new file mode 100644
index 00000000..093bdef8
--- /dev/null
+++ b/environments/maho/init.env
@@ -0,0 +1,27 @@
+DB_DISTRIBUTION=mariadb
+DB_DISTRIBUTION_VERSION=12.2
+NODE_VERSION=24
+COMPOSER_VERSION=2
+PHP_VERSION=8.5
+PHP_XDEBUG_3=1
+
+WARDEN_DB=1
+WARDEN_RABBITMQ=0
+WARDEN_REDIS=0
+
+WARDEN_ELASTICSEARCH=0
+WARDEN_ELASTICHQ=0
+WARDEN_OPENSEARCH=0
+WARDEN_VARNISH=0
+
+WARDEN_SYNC_IGNORE=
+
+WARDEN_ALLURE=0
+WARDEN_SELENIUM=0
+WARDEN_SELENIUM_DEBUG=0
+WARDEN_BLACKFIRE=0
+
+BLACKFIRE_CLIENT_ID=
+BLACKFIRE_CLIENT_TOKEN=
+BLACKFIRE_SERVER_ID=
+BLACKFIRE_SERVER_TOKEN=
diff --git a/environments/maho/maho.base.yml b/environments/maho/maho.base.yml
new file mode 100644
index 00000000..ff51aa58
--- /dev/null
+++ b/environments/maho/maho.base.yml
@@ -0,0 +1,13 @@
+services:
+  nginx:
+    environment:
+      - NGINX_PUBLIC=/public
+      - NGINX_TEMPLATE=maho.conf
+
+  php-fpm:
+    environment:
+      - MAGE_IS_DEVELOPER_MODE=1
+
+  php-debug:
+    environment:
+      - MAGE_IS_DEVELOPER_MODE=1
diff --git a/environments/maho/maho.darwin.yml b/environments/maho/maho.darwin.yml
new file mode 100644
index 00000000..9d4b595f
--- /dev/null
+++ b/environments/maho/maho.darwin.yml
@@ -0,0 +1,11 @@
+
+x-volumes: &volumes
+  - appdata:/var/www/html
+
+services:
+  nginx: { volumes: *volumes }
+  php-fpm: { volumes: *volumes }
+  php-debug: { volumes: *volumes }
+
+volumes:
+  appdata:
diff --git a/environments/maho/maho.mutagen.yml b/environments/maho/maho.mutagen.yml
new file mode 100644
index 00000000..f77d92a2
--- /dev/null
+++ b/environments/maho/maho.mutagen.yml
@@ -0,0 +1,26 @@
+---
+sync:
+  defaults:
+    mode: two-way-resolved
+    watch:
+      pollingInterval: 10
+    ignore:
+      vcs: true
+      paths:
+        # Root .git folder
+        - "/.git/"
+
+        # System files
+        - ".DS_Store"
+        - "._*"
+
+        # Vim files
+        - "*~"
+        - "*.sw[a-p]"
+
+        # Maho files (cache, logs, sessions, locks)
+        - "/var/**"
+
+    permissions:
+      defaultFileMode: "0644"
+      defaultDirectoryMode: "0755"