Automatic setup — Nextcloud latest Administration Manual latest documentation

# Automatic setup

If you need to install Nextcloud on multiple servers, you normally do not want to set up each instance separately as described in Database configuration. For this reason, Nextcloud provides an automatic configuration feature.

To take advantage of this feature, you must create a configuration file, called `config/autoconfig.php`, and set the file parameters as required. You can specify any number of parameters in this file. Any unspecified parameters appear on the “Finish setup” screen when you first launch Nextcloud.

The `config/autoconfig.php` is automatically removed after the initial configuration has been applied.

Note

Keep in mind that the automatic configuration does not eliminate the need for creating the database user and database in advance, as described in Database configuration.

## Parameters

When configuring parameters, you must understand that two parameters are named differently in this configuration file when compared to the standard `config.php` file.

autoconfig.php | config.php
--- | ---
directory | datadirectory
dbpass | dbpassword

## Automatic configurations examples

The following sections provide sample automatic configuration examples and what information is requested at the end of the configuration.

### Data Directory

Using the following parameter settings, the “Finish setup” screen requests database and admin credentials settings.

    <?php
    $AUTOCONFIG = [
      "directory"     => "/www/htdocs/nextcloud/data",
    ];

### SQLite database

Using the following parameter settings, the “Finish setup” screen requests data directory and admin credentials settings.

    <?php
    $AUTOCONFIG = [
      "dbtype"        => "sqlite",
      "dbname"        => "nextcloud",
      "dbtableprefix" => "",
    ];

### MySQL database

Using the following parameter settings, the “Finish setup” screen requests data directory and admin credentials settings.

    <?php
    $AUTOCONFIG = array(
      "dbtype"        => "mysql",
      "dbname"        => "nextcloud",
      "dbuser"        => "username",
      "dbpass"        => "password",
      "dbhost"        => "localhost",
      "dbtableprefix" => "",
    );

### PostgreSQL database

Using the following parameter settings, the “Finish setup” screen requests data directory and admin credentials settings.

    <?php
    $AUTOCONFIG = array(
      "dbtype"        => "pgsql",
      "dbname"        => "nextcloud",
      "dbuser"        => "username",
      "dbpass"        => "password",
      "dbhost"        => "localhost",
      "dbtableprefix" => "",
    );

Note

Keep in mind that the automatic configuration does not eliminate the need for creating the database user and database in advance, as described in Database configuration.

### All parameters

Using the following parameter settings, because all parameters are already configured in the file, the Nextcloud installation skips the “Finish setup” screen.

    <?php
    $AUTOCONFIG = array(
      "dbtype"        => "mysql",
      "dbname"        => "nextcloud",
      "dbuser"        => "username",
      "dbpass"        => "password",
      "dbhost"        => "localhost",
      "dbtableprefix" => "",
      "adminlogin"    => "root",
      "adminpass"     => "root-password",
      "directory"     => "/www/htdocs/nextcloud/data",
    );

Note

Keep in mind that the automatic configuration does not eliminate the need for creating the database user and database in advance, as described in Database configuration.

Read the Docs v: latest

Versions
  20
  21
  22
  stable
  latest

Downloads

On Read the Docs
  Project Home
  Builds