Skip to content

docs(admin): update pdo_mysql config section #16032

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
MichaIng wants to merge 2 commits into
base: master
Choose a base branch
from
Open

docs(admin): update pdo_mysql config section #16032

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
e7b8ad1
docs(admin): update pdo_mysql config section
MichaIng Nov 10, 2026
4422c8e
docs(admin): make use of code blocks
MichaIng Nov 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
53 changes: 20 additions & 33 deletions admin_manual/configuration_database/linux_database_configuration.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ If you decide to use a MySQL or MariaDB database, ensure the following:

Verify the **transaction_isolation** and **binlog_format**:

::
.. code-block:: ini

[mysqld]
...
Expand All @@ -61,7 +61,7 @@ If you decide to use a MySQL or MariaDB database, ensure the following:

Your :file:`/etc/mysql/my.cnf` could look like this:

::
.. code-block:: ini

[server]
skip_name_resolve = 1
Expand Down Expand Up @@ -100,30 +100,17 @@ Please refer to the `page in the MySQL manual <https://mariadb.com/kb/en/library

* That you have installed and enabled the pdo_mysql extension in PHP

* That the **mysql.default_socket** points to the correct socket (if the database runs on the same server as Nextcloud).
* That the **pdo_mysql.default_socket** points to the correct socket (if the database runs on the same server as Nextcloud).
This is usually correct without any adjustments. But if PHP fails to find the socket, it can be defined in the PHP configuration in :file:`/etc/php/**/pdo_mysql.ini` like this:

.. note:: MariaDB is backwards compatible with MySQL. All instructions work for both. You will not need to replace mysql with anything.
.. code-block:: ini

The PHP configuration in :file:`/etc/php7/conf.d/mysql.ini` could look like this:

::

# configuration for PHP MySQL module
; configuration for PHP MySQL module
extension=pdo_mysql.so

[mysql]
mysql.allow_local_infile=On
mysql.allow_persistent=On
mysql.cache_size=2000
mysql.max_persistent=-1
mysql.max_links=-1
mysql.default_port=
mysql.default_socket=/var/lib/mysql/mysql.sock # Debian squeeze: /var/run/mysqld/mysqld.sock
mysql.default_host=
mysql.default_user=
mysql.default_password=
mysql.connect_timeout=60
mysql.trace_mode=Off
pdo_mysql.default_socket=/run/mysqld/mysqld.sock

.. note:: MariaDB is backwards compatible with MySQL. All instructions work for both. You will not need to replace mysql with anything.

Now you need to create a database user and the database itself by using the
MySQL command line interface. The database tables will be created by Nextcloud
Expand All @@ -139,7 +126,7 @@ When using MariaDB use::

Then a **mysql>** or **MariaDB [root]>** prompt will appear. Now enter the following lines and confirm them with the enter key:

::
.. code-block:: sql

CREATE USER 'username'@'localhost' IDENTIFIED BY 'password';
CREATE DATABASE IF NOT EXISTS nextcloud CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;
Expand All @@ -155,7 +142,7 @@ name of the database. The :file:`config/config.php` as created by the
:doc:`../installation/installation_wizard` would therefore contain entries like
this:

::
.. code-block:: php

<?php

Expand All @@ -177,7 +164,7 @@ Enabling SSL is only necessary if your database does not reside on the same serv
If you do not connect over localhost and need to allow remote connections then you should enable SSL.
This just covers the SSL database configuration on the Nextcloud server. First you need to configure your database server accordingly.

::
.. code-block:: php

'dbdriveroptions' => [
\PDO::MYSQL_ATTR_SSL_KEY => '/../ssl-key.pem',
Expand Down Expand Up @@ -206,12 +193,12 @@ For further services and users, we recommend to create a separate
database or PostgreSQL instance.

If you decide to use a PostgreSQL database make sure that you have installed
and enabled the PostgreSQL extension in PHP. The PHP configuration in :file:`/etc/php7/conf.d/pgsql.ini` could look
and enabled the PostgreSQL extension in PHP. The PHP configuration in :file:`/etc/php/**/pgsql.ini` could look
like this:

::
.. code-block:: ini

# configuration for PHP PostgreSQL module
; configuration for PHP PostgreSQL module
extension=pdo_pgsql.so
extension=pgsql.so

Expand All @@ -230,7 +217,7 @@ To start the postgres command line mode use::

Then a **template1=#** prompt will appear. Now enter the following lines and confirm them with the enter key:

::
.. code-block:: sql

CREATE USER username CREATEDB;
CREATE DATABASE nextcloud OWNER username TEMPLATE template0 ENCODING 'UTF8';
Expand All @@ -246,7 +233,7 @@ and an empty password to access it, and the name of the database. The :file:`con
created by the :doc:`../installation/installation_wizard` would therefore contain entries like
this:

::
.. code-block:: php

<?php

Expand All @@ -270,7 +257,7 @@ To start the postgres command line mode use::

Then a **postgres=#** prompt will appear. Now enter the following lines and confirm them with the enter key:

::
.. code-block:: sql

CREATE USER username WITH PASSWORD 'password' CREATEDB;
CREATE DATABASE nextcloud TEMPLATE template0 ENCODING 'UTF8';
Expand All @@ -288,7 +275,7 @@ the name of the database. The :file:`config/config.php` as created by the
:doc:`../installation/installation_wizard` would therefore contain entries like
this:

::
.. code-block:: php

<?php

Expand All @@ -306,7 +293,7 @@ As with MySQL, enabling SSL is only necessary if your database does not reside o
Nextcloud instance. First configure your database server accordingly, then add the ``pgsql_ssl``
configuration to your :file:`config/config.php`.

::
.. code-block:: php

'pgsql_ssl' => [
'mode' => 'verify-full',
Expand Down
Loading