Database server requirements

Last updated on
19 May 2026

MariaDB or MySQL

Drupal 10 Drupal 11 Drupal 12
MariaDB (recommended) 10.3.7+ 10.6+ 10.11+
MySQL 5.7.8+ 8.0+ 8.0+

Required configuration

  • InnoDB as the primary storage engine
  • The PDO database extension

Drupal itself will generally operate with a default MariaDB/MySQL configuration. A more complex site will likely require configuration changes for the database.

PostgreSQL

Drupal 10 Drupal 11 Drupal 12
PostgreSQL 12+ 16+ 18+

Required configuration

Drupal 10, 11, and 12 requires that the pg_trgm extension is enabled.

Enabling pg_trgm

To enable, run CREATE EXTENSION pg_trgm; as a user with appropriate permissions (CREATE EXTENSION docs). This must be run while you are connected to the database for your Drupal site. Running it on another database on the same server will not work. Connect to your database by running \connect DBNAME in psql.

See also #2564307: [meta] Remaining Drupal 10/11 PostgreSQL issues.

Note: Some contributed modules include MySQL-specific code. Issue reports can be filed in the contributed modules' queues when this occurs.

SQLite

Drupal 10 Drupal 11 Drupal 12
SQLite 3.26+ 3.45+ 3.45+

Required configuration

Drupal 10 requires that the json1 extension is enabled.

Note: Some contributed modules include MySQL-specific code. Issue reports can be filed in the contributed modules' queues when this occurs.

Other database servers

Microsoft SQL Server and MongoDB are supported by contributed modules, and maybe in Drupal core, see #3457540: [meta] Add database driver for MongoDB to Core as experimental.

Help improve this page

Page status: No known problems

You can: