diff --git a/admin_manual/configuration_database/index.rst b/admin_manual/configuration_database/index.rst
index a7544e82b..9d6b6aee0 100644
--- a/admin_manual/configuration_database/index.rst
+++ b/admin_manual/configuration_database/index.rst
@@ -9,4 +9,5 @@ Database configuration
     linux_database_configuration
     mysql_4byte_support
     bigint_identifiers
+    replication
     splitting
diff --git a/admin_manual/configuration_database/replication.rst b/admin_manual/configuration_database/replication.rst
new file mode 100644
index 000000000..7cf6fc523
--- /dev/null
+++ b/admin_manual/configuration_database/replication.rst
@@ -0,0 +1,14 @@
+===========
+Replication
+===========
+
+.. versionadded:: 29
+
+Nextcloud can natively split read and write operations on a database query level. Replicas are only used for reads. The default database connection will be used for writes and causal reads.
+
+::
+
+	'dbreplica' => [
+            ['user' => 'nextcloud', 'password' => 'password1', 'host' => '10.0.3.1', 'dbname' => 'nextcloud'],
+            ['user' => 'nextcloud', 'password' => 'password2', 'host' => '10.0.3.2', 'dbname' => 'nextcloud'],
+        ],