diff --git a/AGENTS.md b/AGENTS.md
index 4d11ff0ee3..f02f89439a 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -20,7 +20,7 @@ Self-hosted Backend-as-a-Service platform. Hybrid monolithic-microservice archit
 
 - PHP 8.3+, Swoole 6.x (async runtime, replaces PHP-FPM)
 - Utopia PHP framework (HTTP routing, CLI, DI, queue)
-- MongoDB (default), MariaDB, MySQL, PostgreSQL (adapters via utopia-php/database)
+- MongoDB (default), MariaDB, PostgreSQL (adapters via utopia-php/database; use `compose/mariadb.yml` or `compose/postgresql.yml` overlays to switch)
 - Redis (cache, queue, pub/sub)
 - Docker + Traefik (reverse proxy)
 - PHPUnit 12, Pint (PSR-12), PHPStan level 3
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 5d7ab96a4f..e6ced7a314 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -296,7 +296,7 @@ Appwrite stack is a combination of a variety of open-source technologies and too
 ### Other Technologies
 
 - Redis - for managing cache and in-memory data (currently, we do not use Redis for persistent data).
-- MariaDB - for database storage and queries.
+- MongoDB - default database for storage and queries (MariaDB and PostgreSQL also supported via compose overlays).
 - InfluxDB - for managing stats and time-series based data
 - Statsd - for sending data over UDP protocol (using Telegraf)
 - ClamAV - for validating and scanning storage files.