Configuration Parameters¶
Nextcloud uses the config/config.php
file to control server operations.
config/config.sample.php
lists all the configurable parameters within
Nextcloud, along with example or default values. This document provides a more
detailed reference. Most options are configurable on your Admin page, so it
is usually not necessary to edit config/config.php
.
Note
The installer creates a configuration containing the essential parameters.
Only manually add configuration parameters to config/config.php
if you need to
use a special value for a parameter. Do not copy everything from
config/config.sample.php
. Only enter the parameters you wish to modify!
Multiple config.php file¶
Nextcloud supports loading configuration parameters from multiple files.
You can add arbitrary files ending with .config.php
in the config/
directory, for example you could place your email server configuration
in email.config.php
. This allows you to easily create and manage
custom configurations, or to divide a large complex configuration file
into a set of smaller files. These custom files are not overwritten by
Nextcloud, and the values in these files take precedence over config.php
.
Default config.php Examples¶
When you use SQLite as your Nextcloud database, your config.php
looks like
this after installation. The SQLite database is stored in your Nextcloud
data/
directory. SQLite is a simple, lightweight embedded database that
is good for testing and for simple installations, but for production Nextcloud
systems you should use MySQL, MariaDB, or PosgreSQL.
<?php
$CONFIG = array (
'instanceid' => 'occ6f7365735',
'passwordsalt' => '2c5778476346786306303',
'trusted_domains' =>
array (
0 => 'localhost',
1 => 'studio',
),
'datadirectory' => '/var/www/nextcloud/data',
'dbtype' => 'sqlite3',
'version' => '7.0.2.1',
'installed' => true,
);
This example is from a new Nextcloud installation using MariaDB:
<?php
$CONFIG = array (
'instanceid' => 'oc8c0fd71e03',
'passwordsalt' => '515a13302a6b3950a9d0fdb970191a',
'trusted_domains' =>
array (
0 => 'localhost',
1 => 'studio',
2 => '192.168.10.155'
),
'datadirectory' => '/var/www/nextcloud/data',
'dbtype' => 'mysql',
'version' => '7.0.2.1',
'dbname' => 'nextcloud',
'dbhost' => 'localhost',
'dbtableprefix' => 'oc_',
'dbuser' => 'oc_carla',
'dbpassword' => '67336bcdf7630dd80b2b81a413d07',
'installed' => true,
);
App config options¶
Retention for activities of the activity app:
'activity_expire_days' => 365,
Every day a cron job is ran, which deletes all activities for all users
which are older then the number of days that is set for activity_expire_days
'wnd.logging.enable' => true,
This enables debug logs for the windows_network_drive app.