Default Parameters
==================

The following parameters are automatically configured by ownCloud upon the initial admin login.
These parameters are mandatory for the ownCloud instance to operate properly.

+---------------------+---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| **Parameter**       | **Format**                | **Description**                                                                                                                                                                     |
|                     |                           |                                                                                                                                                                                     |
+---------------------+---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| **Debug**           | define("DEBUG", true);    | When set to true, additional information is written to the logs.                                                                                                                    |
|                     |                           | This is to be used only for local development and not in a production environment.                                                                                                  |
|                     |                           |                                                                                                                                                                                     |
+---------------------+---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| **Installed**       | "installed" => false,     | This flag indicates whether the ownCloud instance was installed successfully.                                                                                                       |
|                     |                           | When set to true, the install was successful.                                                                                                                                       |
|                     |                           | When set to false the instance is not properly installed.                                                                                                                           |
|                     |                           |                                                                                                                                                                                     |
+---------------------+---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| **DB Type**         | "dbtype" => "sqlite",     | The dbtype indicates what type of database is being used with this install.                                                                                                         |
|                     |                           |                                                                                                                                                                                     |
|                     |                           |                                                                                                                                                                                     |
+---------------------+---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| **DB Name**         | "dbname" => "owncloud",   | The ownCloud database within the SQL instance.                                                                                                                                      |
|                     |                           | ownCloud database configuration guides use “owncloud” in the instructions, it is the default for this field.                                                                        |
|                     |                           | This may be set to any valid table name.                                                                                                                                            |
|                     |                           | If the table does not exist, the setup will attempt to create it, provided it has proper permissions.                                                                               |
|                     |                           |                                                                                                                                                                                     |
+---------------------+---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| **DB User**         | "dbuser" => "",           | This is the user that ownCloud uses to write to the database.                                                                                                                       |
|                     |                           | This must be unique across ownCloud instances using the same SQL database.                                                                                                          |
|                     |                           | The user will be created when the install wizard is complete.                                                                                                                       |
|                     |                           | Since the database user in the initial login screen has admin privileges (root), ownCloud creates a new user to ensure ownCloud does not run with unnecessary database permissions. |
|                     |                           | ownCloud prefixes “oc\_” to the userid to prevent a collision between the ownCloud admin user and any existing database users.                                                      |
|                     |                           | This is generated at the time of the initial login and is the Admin User as entered by the ownCloud admin.                                                                          |
|                     |                           |                                                                                                                                                                                     |
+---------------------+---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| **DB Password**     | "dbpassword" => "",       | When a new database user is created for ownCloud, a password for the database is generated by hashing the admin user password.                                                      |
|                     |                           | This hash is stored in this parameter.                                                                                                                                              |
|                     |                           |                                                                                                                                                                                     |
+---------------------+---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| **DB Host**         | "dbhost" => "",           | This parameter shows the location of the database.                                                                                                                                  |
|                     |                           | Can be an IP pointing to the database server, a Fully Qualified Domain Name (FQDN) or localhost.                                                                                    |
|                     |                           |                                                                                                                                                                                     |
+---------------------+---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| **DB Table Prefix** | "dbtableprefix" => "oc\_",| All tables in the database will begin with this prefix.                                                                                                                             |
|                     |                           | By default the prefix is “oc\_”.                                                                                                                                                    |
|                     |                           | If this prefix is changed in the config file, the tables in the database will need to be manually renamed.                                                                          |
|                     |                           | ownCloud will not detect a change to this option so changing this prefix without manually renaming the tables will break the instance of ownCloud.                                  |
|                     |                           |                                                                                                                                                                                     |
+---------------------+---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| **Password Salt**   | "passwordsalt" => "",     | This is the salt used to hash passwords within the ownCloud instance.                                                                                                               |
|                     |                           | It is important not to remove or lose this password.                                                                                                                                |
|                     |                           | If lost, all passwords within the ownCloud instance will be lost.                                                                                                                   |
|                     |                           |                                                                                                                                                                                     |
+---------------------+---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| **Data Directory**  | "datadirectory" => "",    | This parameter tells ownCloud where the default data directory is located.                                                                                                          |
|                     |                           | It is configured in the installation wizard.                                                                                                                                        |
|                     |                           | If using SQLITE, the database is stored in this data directory as well.                                                                                                             |
|                     |                           |                                                                                                                                                                                     |
|                     |                           |                                                                                                                                                                                     |
+---------------------+---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| **Trusted Domains** |   'trusted_domains' =>    | This parameter identifies trusted URL for ownCloud which users may log into.                                                                                                        |
|                     |                           | The initial entry ‘0’ is automatic.                                                                                                                                                 |
|                     |   array (                 | If it is desired to have additional entries, these may be added manually.                                                                                                           |
|                     |                           | This is used to mitigate Header Post Poisoning attacks.                                                                                                                             |
|                     |     0 => ‘A.B.C.D         |                                                                                                                                                                                     |
|                     | ',                        |                                                                                                                                                                                     |
|                     |                           |                                                                                                                                                                                     |
|                     |   ),                      |                                                                                                                                                                                     |
|                     |                           |                                                                                                                                                                                     |
|                     |                           |                                                                                                                                                                                     |
+---------------------+---------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

