Mass Deployment And Account Creation — Nextcloud latest Administration Manual latest documentation

# Mass Deployment And Account Creation

It is possible to perform mass deployment of the Nextcloud desktop client by passing certain command-line parameters from the deployment step to Nextcloud desktop client executable after the initial setup. This will allow desktop client to generate a config (.cfg) file that will be used during subsequent launches. A config file will have a corresponding account written into it similar to if you have added it manually via the desktop client’s UI. The desktop client will exit with code 0 if account has been added successfully, or 1 in case of failure. Detailed failure message is printed to the desktop client logs.

The following parameters are supported:

`--userid`

  (required) userId (username as on the server) to pass when creating an account via command-line.

`--apppassword`

  (required) appPassword to pass when creating an account via command-line (see the `login-flow` section in server documentation on how to generate the app password).

`--localdirpath`

  (optional) path where to create a local sync folder when creating an account via command-line. If skipped, then default local sync folder path (/home/<userid>/Nextcloud<n> for Linux/mac or C:/<userid>/Nextcloud<n> for Windows) will be generated by desktop client.

`--isvfsenabled`

  (optional) whether to set a VFS or non-VFS folder (1 for ‘yes’ or 0 for ‘no’) when creating an account via command-line. Default is 0.

`--remotedirpath`

  (optional) path to a remote subfolder when creating an account via command-line. e.g. If the server has folders “/Photos”, “/Documents”, “/Music” you can pass “/Music” and then this folder will get set up as remote root.

`--serverurl`

  (required) a server URL to use when creating an account via command-line. (NOTE: There is another parameter supported by Nextcloud desktop client `--overrideserverurl` but it SHOULD NOT be used here as it is intended for setup via UI with wizard)

Examples:

- `C:\Program Files\Nextcloud\nextcloud.exe" --userid admin --apppassword Jliy12356785jxnHa2ZCiZ9MX48ncECwDso95Pq3a5HABjY34ZvhZiXrPfpKWUg7aOHAX5 --localdirpath "D:\\Nextcloud-sync-folder" --remotedirpath /Music --serverurl "https://cloud.example.com" --isvfsenabled 1"` - this will create a config file for user admin on the server https://cloud.example.com and set a remote root folder to “Music”, the local sync folder will get created with VFS mode.

- For Linux and mac the same example as above will work but `nextcloud.exe path` and `--localdirpath` value should get changed to platform specific format (e.g. `no .exe extension` and `/home/<user folder>` format)

☁️ latest

☁️ Versions
  latest
  stable
  32
  31