|
|
@@ -0,0 +1,285 @@ |
|
|
|
<?php |
|
|
|
|
|
|
|
/** |
|
|
|
* This configuration file is only provided to document the different |
|
|
|
* configuration options and their usage. |
|
|
|
* |
|
|
|
* DO NOT COMPLETELY BASE YOUR CONFIGURATION FILE ON THIS SAMPLE. THIS MAY BREAK |
|
|
|
* YOUR INSTANCE. Instead, manually copy configuration switches that you |
|
|
|
* consider important for your instance to your working ``config.php``, and |
|
|
|
* apply configuration options that are pertinent for your instance. |
|
|
|
* |
|
|
|
* This file is used to generate the configuration documentation. |
|
|
|
* Please consider following requirements of the current parser: |
|
|
|
* * all comments need to start with `/**` and end with ` *\/` - each on their |
|
|
|
* own line |
|
|
|
* * add a `@see CONFIG_INDEX` to copy a previously described config option |
|
|
|
* also to this line |
|
|
|
* * everything between the ` *\/` and the next `/**` will be treated as the |
|
|
|
* config option |
|
|
|
* * use RST syntax |
|
|
|
*/ |
|
|
|
|
|
|
|
$CONFIG = array( |
|
|
|
|
|
|
|
|
|
|
|
/** |
|
|
|
* Your list of trusted domains that users can log into. Specifying trusted |
|
|
|
* domains prevents host header poisoning. Do not remove this, as it performs |
|
|
|
* necessary security checks. |
|
|
|
* You can specify: |
|
|
|
* |
|
|
|
* - the exact hostname of your host or virtual host, e.g. demo.example.org. |
|
|
|
* - the exact hostname with permitted port, e.g. demo.example.org:443. |
|
|
|
* This disallows all other ports on this host |
|
|
|
* - use * as a wildcard, e.g. ubos-raspberry-pi*.local will allow |
|
|
|
* ubos-raspberry-pi.local and ubos-raspberry-pi-2.local |
|
|
|
*/ |
|
|
|
'trusted_domains' => |
|
|
|
array ( |
|
|
|
'localhost', |
|
|
|
'{{inventory_hostname}}', |
|
|
|
), |
|
|
|
|
|
|
|
|
|
|
|
/** |
|
|
|
* Where user files are stored. The SQLite database is also stored here, when |
|
|
|
* you use SQLite. |
|
|
|
* |
|
|
|
* Default to ``data/`` in the Nextcloud directory. |
|
|
|
*/ |
|
|
|
'datadirectory' => '{{nextcloud_data_directory}}', |
|
|
|
|
|
|
|
|
|
|
|
/** |
|
|
|
* Identifies the database used with this installation. See also config option |
|
|
|
* ``supportedDatabases`` |
|
|
|
* |
|
|
|
* Available: |
|
|
|
* - sqlite (SQLite3) |
|
|
|
* - mysql (MySQL/MariaDB) |
|
|
|
* - pgsql (PostgreSQL) |
|
|
|
* |
|
|
|
* Defaults to ``sqlite`` |
|
|
|
*/ |
|
|
|
'dbtype' => '{{ nextcloud_database_type }}', |
|
|
|
|
|
|
|
/** |
|
|
|
* Your host server name, for example ``localhost``, ``hostname``, |
|
|
|
* ``hostname.example.com``, or the IP address. To specify a port use |
|
|
|
* ``hostname:####``; to specify a Unix socket use |
|
|
|
* ``localhost:/path/to/socket``. |
|
|
|
*/ |
|
|
|
'dbhost' => '{{ nextcloud_database_host }}', |
|
|
|
|
|
|
|
/** |
|
|
|
* The name of the Nextcloud database, which is set during installation. You |
|
|
|
* should not need to change this. |
|
|
|
*/ |
|
|
|
'dbname' => '{{ nextcloud_database_name }}', |
|
|
|
|
|
|
|
/** |
|
|
|
* The user that Nextcloud uses to write to the database. This must be unique |
|
|
|
* across Nextcloud instances using the same SQL database. This is set up during |
|
|
|
* installation, so you shouldn't need to change it. |
|
|
|
*/ |
|
|
|
'dbuser' => '{{ nextcloud_database_user }}', |
|
|
|
|
|
|
|
/** |
|
|
|
* The password for the database user. This is set up during installation, so |
|
|
|
* you shouldn't need to change it. |
|
|
|
*/ |
|
|
|
'dbpassword' => '{{ nextcloud_database_password }}', |
|
|
|
|
|
|
|
/** |
|
|
|
* Prefix for the Nextcloud tables in the database. |
|
|
|
* |
|
|
|
* Default to ``oc_`` |
|
|
|
*/ |
|
|
|
'dbtableprefix' => '', |
|
|
|
|
|
|
|
|
|
|
|
/** |
|
|
|
* Indicates whether the Nextcloud instance was installed successfully; ``true`` |
|
|
|
* indicates a successful installation, and ``false`` indicates an unsuccessful |
|
|
|
* installation. |
|
|
|
* |
|
|
|
* Defaults to ``false`` |
|
|
|
*/ |
|
|
|
'installed' => false, |
|
|
|
|
|
|
|
|
|
|
|
/** |
|
|
|
* User Experience |
|
|
|
* |
|
|
|
* These optional parameters control some aspects of the user interface. Default |
|
|
|
* values, where present, are shown. |
|
|
|
*/ |
|
|
|
|
|
|
|
/** |
|
|
|
* This sets the default language on your Nextcloud server, using ISO_639-1 |
|
|
|
* language codes such as ``en`` for English, ``de`` for German, and ``fr`` for |
|
|
|
* French. It overrides automatic language detection on public pages like login |
|
|
|
* or shared items. User's language preferences configured under "personal -> |
|
|
|
* language" override this setting after they have logged in. |
|
|
|
* |
|
|
|
* Defaults to ``en`` |
|
|
|
*/ |
|
|
|
'default_language' => '{{nextcloud_default_language}}', |
|
|
|
|
|
|
|
/** |
|
|
|
* With this setting a language can be forced for all users. If a language is |
|
|
|
* forced, the users are also unable to change their language in the personal |
|
|
|
* settings. If users shall be unable to change their language, but users have |
|
|
|
* different languages, this value can be set to ``true`` instead of a language |
|
|
|
* code. |
|
|
|
* |
|
|
|
* Defaults to ``false`` |
|
|
|
*/ |
|
|
|
{% if nextcloud_force_language %} |
|
|
|
'force_language' => '{{nextcloud_force_language}}', |
|
|
|
{% endif %} |
|
|
|
|
|
|
|
/** |
|
|
|
* Set the default app to open on login. Use the app names as they appear in the |
|
|
|
* URL after clicking them in the Apps menu, such as documents, calendar, and |
|
|
|
* gallery. You can use a comma-separated list of app names, so if the first |
|
|
|
* app is not enabled for a user then Nextcloud will try the second one, and so |
|
|
|
* on. If no enabled apps are found it defaults to the Files app. |
|
|
|
* |
|
|
|
* Defaults to ``files`` |
|
|
|
*/ |
|
|
|
'defaultapp' => '{{nextcloud_defaultapp}}', |
|
|
|
|
|
|
|
/** |
|
|
|
* Use this configuration parameter to specify the base URL for any URLs which |
|
|
|
* are generated within Nextcloud using any kind of command line tools (cron or |
|
|
|
* occ). The value should contain the full base URL: |
|
|
|
* ``https://www.example.com/nextcloud`` |
|
|
|
* |
|
|
|
* Defaults to ``''`` (empty string) |
|
|
|
*/ |
|
|
|
'overwrite.cli.url' => 'http://{{inventory_hostname}}', |
|
|
|
|
|
|
|
/** |
|
|
|
* To have clean URLs without `/index.php` this parameter needs to be configured. |
|
|
|
* |
|
|
|
* This parameter will be written as "RewriteBase" on update and installation of |
|
|
|
* Nextcloud to your `.htaccess` file. While this value is often simply the URL |
|
|
|
* path of the Nextcloud installation it cannot be set automatically properly in |
|
|
|
* every scenario and needs thus some manual configuration. |
|
|
|
* |
|
|
|
* In a standard Apache setup this usually equals the folder that Nextcloud is |
|
|
|
* accessible at. So if Nextcloud is accessible via "https://mycloud.org/nextcloud" |
|
|
|
* the correct value would most likely be "/nextcloud". If Nextcloud is running |
|
|
|
* under "https://mycloud.org/" then it would be "/". |
|
|
|
* |
|
|
|
* Note that the above rule is not valid in every case, as there are some rare setup |
|
|
|
* cases where this may not apply. However, to avoid any update problems this |
|
|
|
* configuration value is explicitly opt-in. |
|
|
|
* |
|
|
|
* After setting this value run `occ maintenance:update:htaccess`. Now, when the |
|
|
|
* following conditions are met Nextcloud URLs won't contain `index.php`: |
|
|
|
* |
|
|
|
* - `mod_rewrite` is installed |
|
|
|
* - `mod_env` is installed |
|
|
|
* |
|
|
|
* Defaults to ``''`` (empty string) |
|
|
|
*/ |
|
|
|
'htaccess.RewriteBase' => '/', |
|
|
|
|
|
|
|
/** |
|
|
|
* Checks an app before install whether it uses private APIs instead of the |
|
|
|
* proper public APIs. If this is set to true it will only allow to install or |
|
|
|
* enable apps that pass this check. |
|
|
|
* |
|
|
|
* Defaults to ``false`` |
|
|
|
*/ |
|
|
|
'appcodechecker' => true, |
|
|
|
|
|
|
|
/** |
|
|
|
* Check if Nextcloud is up-to-date and shows a notification if a new version is |
|
|
|
* available. |
|
|
|
* |
|
|
|
* Defaults to ``true`` |
|
|
|
*/ |
|
|
|
'updatechecker' => true, |
|
|
|
|
|
|
|
|
|
|
|
/** |
|
|
|
* Logging |
|
|
|
*/ |
|
|
|
|
|
|
|
/** |
|
|
|
* By default the Nextcloud logs are sent to the ``nextcloud.log`` file in the |
|
|
|
* default Nextcloud data directory. |
|
|
|
* If syslogging is desired, set this parameter to ``syslog``. |
|
|
|
* Setting this parameter to ``errorlog`` will use the PHP error_log function |
|
|
|
* for logging. |
|
|
|
* |
|
|
|
* Defaults to ``file`` |
|
|
|
*/ |
|
|
|
'log_type' => 'file', |
|
|
|
|
|
|
|
/** |
|
|
|
* Log file path for the Nextcloud logging type. |
|
|
|
* |
|
|
|
* Defaults to ``[datadirectory]/nextcloud.log`` |
|
|
|
*/ |
|
|
|
'logfile' => '/var/log/nextcloud/nextcloud.log', |
|
|
|
|
|
|
|
/** |
|
|
|
* Loglevel to start logging at. Valid values are: 0 = Debug, 1 = Info, 2 = |
|
|
|
* Warning, 3 = Error, and 4 = Fatal. The default value is Warning. |
|
|
|
* |
|
|
|
* Defaults to ``2`` |
|
|
|
*/ |
|
|
|
'loglevel' => 2, |
|
|
|
|
|
|
|
|
|
|
|
/** |
|
|
|
* The timezone for logfiles. You may change this; see |
|
|
|
* http://php.net/manual/en/timezones.php |
|
|
|
* |
|
|
|
* Defaults to ``UTC`` |
|
|
|
*/ |
|
|
|
'logtimezone' => 'UTC', |
|
|
|
|
|
|
|
|
|
|
|
/** |
|
|
|
* Apps |
|
|
|
* |
|
|
|
* Options for the Apps folder, Apps store, and App code checker. |
|
|
|
*/ |
|
|
|
|
|
|
|
/** |
|
|
|
* When enabled, admins may install apps from the Nextcloud app store. |
|
|
|
* |
|
|
|
* Defaults to ``true`` |
|
|
|
*/ |
|
|
|
'appstoreenabled' => false, |
|
|
|
|
|
|
|
/** |
|
|
|
* Use the ``apps_paths`` parameter to set the location of the Apps directory, |
|
|
|
* which should be scanned for available apps, and where user-specific apps |
|
|
|
* should be installed from the Apps store. The ``path`` defines the absolute |
|
|
|
* file system path to the app folder. The key ``url`` defines the HTTP Web path |
|
|
|
* to that folder, starting from the Nextcloud webroot. The key ``writable`` |
|
|
|
* indicates if a Web server can write files to that folder. |
|
|
|
*/ |
|
|
|
'apps_paths' => array( |
|
|
|
array( |
|
|
|
'path'=> '/var/www/nextcloud/apps', |
|
|
|
'url' => '/apps', |
|
|
|
'writable' => false, |
|
|
|
), |
|
|
|
), |
|
|
|
|
|
|
|
|
|
|
|
/** |
|
|
|
* Disable the web based updater |
|
|
|
*/ |
|
|
|
'upgrade.disable-web' => true, |
|
|
|
|
|
|
|
|
|
|
|
); |