Articles in this section

Bootstrapping Management console automatically

Resilio Administrator might need to automate installing and configuring the Management Console. This guide shows how to fully automate Management console bootstrapping (supported for version 2.12.5 and newer).

1. On Windows, download MC msi installer. Do not launch it.
On Linux download tar and unpack it, run update-or-install.py script from there. Do not start the MC itself.

2. Create folder named bootstrap in MC's storage directory: 

Windows: C:\ProgramData\Resilio\Connect Server\bootstrap
Linux: {unpack path}/var/bootstrap

3. Create config.json with the following information:

  • license. Open the Resilio license file in a text editor, and copy its content (it starts with btos1_ey)
  • agree to EULA - yes
  • user e-mail
  • username
  • password. Be sure to comply with the password complexity policy 
  • API token description
{
  "license": "btos1_eyJzIjog...J9",
  "eula": "yes",
  "user": {
     "email": "admin@example.com",
     "username": "admin@example.com",
     "password": "MyStrongPassword"
  },
  "token": {
    "description": "Admin's API token"
  }
}

4. Start the Resilio Connect Management Console installer. When started for the first time (fresh install with empty storage folder) it checks for the bootstrap folder and its content. 

If the folder doesn’t exist, regular installation continues and the Management Console records ‘auto installation path not found’ into the data/common.log file.

If the folder does exist, but the data there is incorrect, the Management console will report an error in the data/common.log.

If the bootstrap folder does exist, and the information in config.json file is correct, the Management console will pull information from it and perform installation:
- the bootstrap folder will be renamed to 'bootstrap performed'.
- API token will be generated and recorded it into token.txt file in this folder. Be sure to save it in a safe place.
- the MC will automatically apply the license from config.json.
- SuperAdmin user will be created on the MC using the credentials from the config.jsonmceclip1.png

Once the installation is complete, the Management Console is going to ignore "bootstrap performed" directory. 

5. Generate Agent Config file using Management Console API 
Using call GetAgentConfig fetch the configuration file. Some parameters, but not all, can be defined right in the call. Adjust the fetched configuration file if necessary. 

Related articles