Update Docker Compose and application configuration to support MongoDB as the primary database, replacing all instances of MariaDB. Introduce a new environment variable for database selection and adjust database schemes in the application initialization.

2026-05-26 13:51:13 +00:00 · 2025-07-31 17:17:08 +03:00
parent 33c5ac83b2
commit 46965135a4
4 changed files with 111 additions and 46 deletions
@@ -342,6 +342,15 @@ return [
            ]
        ],
    ],
+    [
+        'name' => '_APP_DB_ADAPTER',
+        'description' => 'To switch between mariadb and mongoDB',
+        'introduction' => '1.8.0',
+        'default' => 'mongoDB',
+        'required' => true,
+        'question' => 'Choose your database (mariadb|mongoDB)',
+        'filter' => ''
+    ],
    [
        'category' => 'Redis',
        'description' => 'Appwrite uses a Redis server for managing cache, queues and scheduled tasks. The Redis env vars are used to allow Appwrite server to connect to the Redis container.',
@@ -124,19 +124,19 @@ $register->set('pools', function () {
            'type' => 'database',
            'dsns' => $fallbackForDB,
            'multiple' => false,
-            'schemes' => ['mariadb', 'mysql', 'mongodb'],
+            'schemes' => ['mongodb','mariadb', 'mysql'],
        ],
        'database' => [
            'type' => 'database',
            'dsns' => $fallbackForDB,
            'multiple' => true,
-            'schemes' => ['mariadb', 'mysql','mongodb'],
+            'schemes' => ['mongodb','mariadb', 'mysql'],
        ],
        'logs' => [
            'type' => 'database',
            'dsns' => System::getEnv('_APP_CONNECTIONS_DB_LOGS', $fallbackForDB),
            'multiple' => false,
-            'schemes' => ['mariadb', 'mysql', 'mongodb'],
+            'schemes' => ['mongodb','mariadb', 'mysql'],
        ],
        'publisher' => [
            'type' => 'publisher',
@@ -11,6 +11,8 @@ $httpsPort = $this->getParam('httpsPort', '');
 $version = $this->getParam('version', '');
 $organization = $this->getParam('organization', '');
 $image = $this->getParam('image', '');
+$dbService = $this->getParam('database');
+
 ?>services:
  traefik:
    image: traefik:2.11
@@ -69,7 +71,7 @@ $image = $this->getParam('image', '');
      - appwrite-sites:/storage/sites:rw
      - appwrite-builds:/storage/builds:rw
    depends_on:
-      - mariadb
+      - <?= $dbService  . "\n" ?>
      - redis
 #      - clamav
    environment:
@@ -100,6 +102,7 @@ $image = $this->getParam('image', '');
      - _APP_REDIS_PORT
      - _APP_REDIS_USER
      - _APP_REDIS_PASS
+      - _APP_DB_ADAPTER
      - _APP_DB_HOST
      - _APP_DB_PORT
      - _APP_DB_SCHEMA
@@ -219,7 +222,7 @@ $image = $this->getParam('image', '');
    networks:
      - appwrite
    depends_on:
-      - mariadb
+      - <?= $dbService  . "\n" ?>
      - redis
    environment:
      - _APP_ENV
@@ -231,6 +234,7 @@ $image = $this->getParam('image', '');
      - _APP_REDIS_PORT
      - _APP_REDIS_USER
      - _APP_REDIS_PASS
+      - _APP_DB_ADAPTER
      - _APP_DB_HOST
      - _APP_DB_PORT
      - _APP_DB_SCHEMA
@@ -249,7 +253,7 @@ $image = $this->getParam('image', '');
      - appwrite
    depends_on:
      - redis
-      - mariadb
+      - <?= $dbService  . "\n" ?>
    environment:
      - _APP_ENV
      - _APP_WORKER_PER_CORE
@@ -258,6 +262,7 @@ $image = $this->getParam('image', '');
      - _APP_REDIS_PORT
      - _APP_REDIS_USER
      - _APP_REDIS_PASS
+      - _APP_DB_ADAPTER
      - _APP_DB_HOST
      - _APP_DB_PORT
      - _APP_DB_SCHEMA
@@ -275,13 +280,14 @@ $image = $this->getParam('image', '');
      - appwrite
    depends_on:
      - redis
-      - mariadb
+      - <?= $dbService  . "\n" ?>
    environment:
      - _APP_ENV
      - _APP_WORKER_PER_CORE
      - _APP_OPENSSL_KEY_V1
      - _APP_EMAIL_SECURITY
      - _APP_SYSTEM_SECURITY_EMAIL_ADDRESS
+      - _APP_DB_ADAPTER
      - _APP_DB_HOST
      - _APP_DB_PORT
      - _APP_DB_SCHEMA
@@ -303,7 +309,7 @@ $image = $this->getParam('image', '');
      - appwrite
    depends_on:
      - redis
-      - mariadb
+      - <?= $dbService  . "\n" ?>
    volumes:
      - appwrite-uploads:/storage/uploads:rw
      - appwrite-cache:/storage/cache:rw
@@ -319,6 +325,7 @@ $image = $this->getParam('image', '');
      - _APP_REDIS_PORT
      - _APP_REDIS_USER
      - _APP_REDIS_PASS
+      - _APP_DB_ADAPTER
      - _APP_DB_HOST
      - _APP_DB_PORT
      - _APP_DB_SCHEMA
@@ -366,7 +373,7 @@ $image = $this->getParam('image', '');
      - appwrite
    depends_on:
      - redis
-      - mariadb
+      - <?= $dbService  . "\n" ?>
    environment:
      - _APP_ENV
      - _APP_WORKER_PER_CORE
@@ -375,6 +382,7 @@ $image = $this->getParam('image', '');
      - _APP_REDIS_PORT
      - _APP_REDIS_USER
      - _APP_REDIS_PASS
+      - _APP_DB_ADAPTER
      - _APP_DB_HOST
      - _APP_DB_PORT
      - _APP_DB_SCHEMA
@@ -392,7 +400,7 @@ $image = $this->getParam('image', '');
      - appwrite
    depends_on:
      - redis
-      - mariadb
+      - <?= $dbService  . "\n" ?>
    volumes:
      - appwrite-functions:/storage/functions:rw
      - appwrite-sites:/storage/sites:rw
@@ -408,6 +416,7 @@ $image = $this->getParam('image', '');
      - _APP_REDIS_PORT
      - _APP_REDIS_USER
      - _APP_REDIS_PASS
+      - _APP_DB_ADAPTER
      - _APP_DB_HOST
      - _APP_DB_PORT
      - _APP_DB_SCHEMA
@@ -460,7 +469,7 @@ $image = $this->getParam('image', '');
      - appwrite
    depends_on:
      - redis
-      - mariadb
+      - <?= $dbService  . "\n" ?>
    volumes:
      - appwrite-config:/storage/config:rw
      - appwrite-certificates:/storage/certificates:rw
@@ -478,6 +487,7 @@ $image = $this->getParam('image', '');
      - _APP_REDIS_PORT
      - _APP_REDIS_USER
      - _APP_REDIS_PASS
+      - _APP_DB_ADAPTER
      - _APP_DB_HOST
      - _APP_DB_PORT
      - _APP_DB_SCHEMA
@@ -495,7 +505,7 @@ $image = $this->getParam('image', '');
      - appwrite
    depends_on:
      - redis
-      - mariadb
+      - <?= $dbService  . "\n" ?>
      - openruntimes-executor
    environment:
      - _APP_ENV
@@ -507,6 +517,7 @@ $image = $this->getParam('image', '');
      - _APP_REDIS_PORT
      - _APP_REDIS_USER
      - _APP_REDIS_PASS
+      - _APP_DB_ADAPTER
      - _APP_DB_HOST
      - _APP_DB_PORT
      - _APP_DB_SCHEMA
@@ -540,6 +551,7 @@ $image = $this->getParam('image', '');
      - _APP_OPENSSL_KEY_V1
      - _APP_SYSTEM_EMAIL_NAME
      - _APP_SYSTEM_EMAIL_ADDRESS
+      - _APP_DB_ADAPTER
      - _APP_DB_HOST
      - _APP_DB_PORT
      - _APP_DB_SCHEMA
@@ -578,6 +590,7 @@ $image = $this->getParam('image', '');
      - _APP_REDIS_PORT
      - _APP_REDIS_USER
      - _APP_REDIS_PASS
+      - _APP_DB_ADAPTER
      - _APP_DB_HOST
      - _APP_DB_PORT
      - _APP_DB_SCHEMA
@@ -620,7 +633,7 @@ $image = $this->getParam('image', '');
    volumes:
      - appwrite-imports:/storage/imports:rw
    depends_on:
-      - mariadb
+      - <?= $dbService  . "\n" ?>
    environment:
      - _APP_ENV
      - _APP_WORKER_PER_CORE
@@ -634,6 +647,7 @@ $image = $this->getParam('image', '');
      - _APP_REDIS_PORT
      - _APP_REDIS_USER
      - _APP_REDIS_PASS
+      - _APP_DB_ADAPTER
      - _APP_DB_HOST
      - _APP_DB_PORT
      - _APP_DB_SCHEMA
@@ -666,6 +680,7 @@ $image = $this->getParam('image', '');
      - _APP_REDIS_PORT
      - _APP_REDIS_USER
      - _APP_REDIS_PASS
+      - _APP_DB_ADAPTER
      - _APP_DB_HOST
      - _APP_DB_PORT
      - _APP_DB_SCHEMA
@@ -690,11 +705,12 @@ $image = $this->getParam('image', '');
      - appwrite
    depends_on:
      - redis
-      - mariadb
+      - <?= $dbService  . "\n" ?>
    environment:
      - _APP_ENV
      - _APP_WORKER_PER_CORE
      - _APP_OPENSSL_KEY_V1
+      - _APP_DB_ADAPTER
      - _APP_DB_HOST
      - _APP_DB_PORT
      - _APP_DB_SCHEMA
@@ -719,11 +735,12 @@ $image = $this->getParam('image', '');
      - appwrite
    depends_on:
      - redis
-      - mariadb
+      - <?= $dbService  . "\n" ?>
    environment:
      - _APP_ENV
      - _APP_WORKER_PER_CORE
      - _APP_OPENSSL_KEY_V1
+      - _APP_DB_ADAPTER
      - _APP_DB_HOST
      - _APP_DB_PORT
      - _APP_DB_SCHEMA
@@ -747,11 +764,13 @@ $image = $this->getParam('image', '');
      - appwrite
    depends_on:
      - redis
-      - mariadb
+      - <?= $dbService  . "\n" ?>
    environment:
      - _APP_ENV
      - _APP_WORKER_PER_CORE
      - _APP_OPENSSL_KEY_V1
+      - _APP_DB_ADAPTER
+      - _APP_DB_ADAPTER
      - _APP_DB_HOST
      - _APP_DB_PORT
      - _APP_DB_SCHEMA
@@ -774,7 +793,7 @@ $image = $this->getParam('image', '');
    networks:
      - appwrite
    depends_on:
-      - mariadb
+      - <?= $dbService  . "\n" ?>
      - redis
    environment:
      - _APP_ENV
@@ -784,6 +803,7 @@ $image = $this->getParam('image', '');
      - _APP_REDIS_PORT
      - _APP_REDIS_USER
      - _APP_REDIS_PASS
+      - _APP_DB_ADAPTER
      - _APP_DB_HOST
      - _APP_DB_PORT
      - _APP_DB_SCHEMA
@@ -799,7 +819,7 @@ $image = $this->getParam('image', '');
    networks:
      - appwrite
    depends_on:
-      - mariadb
+      - <?= $dbService  . "\n" ?>
      - redis
    environment:
      - _APP_ENV
@@ -809,6 +829,7 @@ $image = $this->getParam('image', '');
      - _APP_REDIS_PORT
      - _APP_REDIS_USER
      - _APP_REDIS_PASS
+      - _APP_DB_ADAPTER
      - _APP_DB_HOST
      - _APP_DB_PORT
      - _APP_DB_SCHEMA
@@ -824,7 +845,7 @@ $image = $this->getParam('image', '');
    networks:
      - appwrite
    depends_on:
-      - mariadb
+      - <?= $dbService  . "\n" ?>
      - redis
    environment:
      - _APP_ENV
@@ -834,6 +855,7 @@ $image = $this->getParam('image', '');
      - _APP_REDIS_PORT
      - _APP_REDIS_USER
      - _APP_REDIS_PASS
+      - _APP_DB_ADAPTER
      - _APP_DB_HOST
      - _APP_DB_PORT
      - _APP_DB_SCHEMA
@@ -910,22 +932,52 @@ $image = $this->getParam('image', '');
      - OPR_EXECUTOR_STORAGE_WASABI_REGION=$_APP_STORAGE_WASABI_REGION
      - OPR_EXECUTOR_STORAGE_WASABI_BUCKET=$_APP_STORAGE_WASABI_BUCKET

-  mariadb:
-    image: mariadb:10.11 # fix issues when upgrading using: mysql_upgrade -u root -p
-    container_name: appwrite-mariadb
+      <?php if ($dbService === 'mariadb'): ?>
+
+mariadb:
+  image: mariadb:10.11
+  container_name: appwrite-mariadb
+  restart: unless-stopped
+  networks:
+    - appwrite
+  volumes:
+    - appwrite-mariadb:/var/lib/mysql:rw
+  environment:
+    - MYSQL_ROOT_PASSWORD=${_APP_DB_ROOT_PASS}
+    - MYSQL_DATABASE=${_APP_DB_SCHEMA}
+    - MYSQL_USER=${_APP_DB_USER}
+    - MYSQL_PASSWORD=${_APP_DB_PASS}
+    - MARIADB_AUTO_UPGRADE=1
+  command: 'mysqld --innodb-flush-method=fsync'
+
+<?php elseif ($dbService === 'mongodb'): ?>
+
+  mongodb:
+    image: mongo:latest
+    container_name: appwrite-mongodb
    <<: *x-logging
-    restart: unless-stopped
    networks:
      - appwrite
    volumes:
-      - appwrite-mariadb:/var/lib/mysql:rw
+      - appwrite-mongodb:/data/db
+      # we need to run the mongo-init.js file to create the user and the database
+      - ./mongo-init.js:/docker-entrypoint-initdb.d/mongo-init.js:ro
+    ports:
+      - "27017:27017"
    environment:
-      - MYSQL_ROOT_PASSWORD=${_APP_DB_ROOT_PASS}
-      - MYSQL_DATABASE=${_APP_DB_SCHEMA}
-      - MYSQL_USER=${_APP_DB_USER}
-      - MYSQL_PASSWORD=${_APP_DB_PASS}
-      - MARIADB_AUTO_UPGRADE=1
-    command: 'mysqld --innodb-flush-method=fsync'
+      - MONGO_INITDB_ROOT_USERNAME=root
+      - MONGO_INITDB_ROOT_PASSWORD=${_APP_DB_ROOT_PASS}
+      - MONGO_INITDB_DATABASE=${_APP_DB_SCHEMA}
+      - MONGO_INITDB_USERNAME=${_APP_DB_USER}
+      - MONGO_INITDB_PASSWORD=${_APP_DB_PASS}
+    healthcheck:
+      test: ["CMD", "mongosh", "--username", "root", "--password", "${_APP_DB_ROOT_PASS}", "--authenticationDatabase", "admin", "--eval", "db.adminCommand('ping')"]
+      interval: 1s
+      timeout: 5s
+      retries: 10
+      start_period: 30s
+
+<?php endif; ?>

  redis:
    image: redis:7.2.4-alpine
@@ -960,7 +1012,11 @@ networks:
    name: runtimes

 volumes:
+<?php if ($dbService === 'mariadb'): ?>
  appwrite-mariadb:
+<?php elseif ($dbService === 'mongodb'): ?>
+  appwrite-mongodb:
+<?php endif; ?>
  appwrite-redis:
  appwrite-cache:
  appwrite-uploads:
@@ -267,7 +267,7 @@ services:
      - ./app:/usr/src/code/app
      - ./src:/usr/src/code/src
    depends_on:
-      - mariadb
+      - ${_APP_DB_HOST:-mongodb}
      - redis
    environment:
      - _APP_ENV
@@ -301,7 +301,7 @@ services:
      - ./src:/usr/src/code/src
    depends_on:
      - redis
-      - mariadb
+      - ${_APP_DB_HOST:-mongodb}
    environment:
      - _APP_ENV
      - _APP_WORKER_PER_CORE
@@ -331,7 +331,7 @@ services:
      - ./src:/usr/src/code/src
    depends_on:
      - redis
-      - mariadb
+      - ${_APP_DB_HOST:-mongodb}
      - request-catcher-sms
      - request-catcher-webhook
    environment:
@@ -362,7 +362,7 @@ services:
      - appwrite
    depends_on:
      - redis
-      - mariadb
+      - ${_APP_DB_HOST:-mongodb}
    volumes:
      - appwrite-uploads:/storage/uploads:rw
      - appwrite-cache:/storage/cache:rw
@@ -429,7 +429,7 @@ services:
      - ./src:/usr/src/code/src
    depends_on:
      - redis
-      - mariadb
+      - ${_APP_DB_HOST:-mongodb}
    environment:
      - _APP_ENV
      - _APP_WORKER_PER_CORE
@@ -465,7 +465,7 @@ services:
      - ./src:/usr/src/code/src
    depends_on:
      - redis
-      - mariadb
+      - ${_APP_DB_HOST:-mongodb}
    environment:
      - _APP_BROWSER_HOST
      - _APP_ENV
@@ -533,7 +533,7 @@ services:
      - appwrite
    depends_on:
      - redis
-      - mariadb
+      - ${_APP_DB_HOST:-mongodb}
    volumes:
      - appwrite-config:/storage/config:rw
      - appwrite-certificates:/storage/certificates:rw
@@ -574,7 +574,7 @@ services:
      - ./src:/usr/src/code/src
    depends_on:
      - redis
-      - mariadb
+      - ${_APP_DB_HOST:-mongodb}
      - openruntimes-executor
    environment:
      - _APP_ENV
@@ -710,7 +710,7 @@ services:
      - ./src:/usr/src/code/src
      - ./tests:/usr/src/code/tests
    depends_on:
-      - mariadb
+      - ${_APP_DB_HOST:-mongodb}
    environment:
      - _APP_ENV
      - _APP_WORKER_PER_CORE
@@ -789,7 +789,7 @@ services:
      - ./src:/usr/src/code/src
    depends_on:
      - redis
-      - mariadb
+      - ${_APP_DB_HOST:-mongodb}
    environment:
      - _APP_ENV
      - _APP_WORKER_PER_CORE
@@ -821,7 +821,7 @@ services:
      - ./src:/usr/src/code/src
    depends_on:
      - redis
-      - mariadb
+      - ${_APP_DB_HOST:-mongodb}
    environment:
      - _APP_ENV
      - _APP_WORKER_PER_CORE
@@ -853,7 +853,7 @@ services:
      - ./src:/usr/src/code/src
    depends_on:
      - redis
-      - mariadb
+      - ${_APP_DB_HOST:-mongodb}
    environment:
      - _APP_ENV
      - _APP_WORKER_PER_CORE
@@ -884,7 +884,7 @@ services:
      - ./app:/usr/src/code/app
      - ./src:/usr/src/code/src
    depends_on:
-      - mariadb
+      - ${_APP_DB_HOST:-mongodb}
      - redis
    environment:
      - _APP_ENV
@@ -913,7 +913,7 @@ services:
      - ./app:/usr/src/code/app
      - ./src:/usr/src/code/src
    depends_on:
-      - mariadb
+      - ${_APP_DB_HOST:-mongodb}
      - redis
    environment:
      - _APP_ENV
@@ -941,7 +941,7 @@ services:
      - ./app:/usr/src/code/app
      - ./src:/usr/src/code/src
    depends_on:
-      - mariadb
+      - ${_APP_DB_HOST:-mongodb}
      - redis
    environment:
      - _APP_ENV
@@ -1066,7 +1066,7 @@ services:
    command: "mysqld --innodb-flush-method=fsync"

  mongodb:
-    image: mongo:latest
+    image: mongo:8.0.10
    container_name: appwrite-mongodb
    <<: *x-logging
    networks: