Client Applications

HOWTO: Manually Initialize or Deploy a Nuxeo Drive Instance

Updated: August 19, 2019

Usually Nuxeo Drive is initialized when the user completes the Settings panel and successfully logs in. But for auto deployment you might want to use the command line or EXE.

Command Line

You can bind a new engine on Nuxeo Drive by calling the ndrive executable with the following arguments. It is recommended to have your Drive not running while executing this command.

ndrive bind-server [--password PASSWORD] [--local-folder LOCALFOLDER] USERNAME URL

More information about the parameters:

  • USERNAME: The username of the user who will be using Nuxeo Drive. Mandatory.
  • URL: The URL of the Nuxeo server. Mandatory.
  • PASSWORD: The password of the user who will be using Nuxeo Drive. If you don't specify the PASSWORD then it will be asked to the user when Nuxeo Drive is started.
  • LOCALFOLDER: The path to the Nuxeo Drive folder that will be created. Path must include the Nuxeo Drive folder. If LOCALFOLDER is not specified then the default location will be picked.

Installer

On Windows you can automatically call the bind-server command on install if you set up the EXE variables:

  • TARGETURL: The URL of the Nuxeo server. Mandatory.
  • TARGETUSERNAME: The username of the user who will be using Nuxeo Drive. Mandatory.
  • TARGETPASSWORD: The password of the user who will be using Nuxeo Drive. If you don't specify it then it will be asked to the user when Nuxeo Drive is started.
  • TARGETDRIVEFOLDER: The path to the Nuxeo Drive folder that will be created. Path must include the Nuxeo Drive folder.
  • START=auto: Start Nuxeo Drive after the installation.

Examples

Install Nuxeo Drive and configure the Nuxeo server to http://localhost:8080/nuxeo with the username username:

nuxeo-drive.exe /SILENT /TARGETURL="http://localhost:8080/nuxeo" /TARGETUSERNAME="username"

Same as above, but add the associated password:

nuxeo-drive.exe /SILENT /TARGETURL="http://localhost:8080/nuxeo" /TARGETUSERNAME="username" /TARGETPASSWORD="password"

A full installation, useful for large automatic deployments:

nuxeo-drive.exe /VERYSILENT /TARGETDRIVEFOLDER="%USERPROFILE%\Documents\Nuxeo Drive" /TARGETURL="http://localhost:8080/nuxeo" /TARGETUSERNAME="foo"

Even if username is wrong, it will allow the customization of the Nuxeo server on all clients. The users will be asked to enter their username and password upon the first connection.


Other documentation about Nuxeo Drive
   

We'd love to hear your thoughts!

All fields required