Right after installation, on a welcome screen Agent suggests connecting it to Resilio Connect Management Console. There are three ways to do it:
Agent UI must be enabled
The welcome screen is only visible when the Agent UI is enabled when generating the config file. Othewise, the only way to connect the agent to Management Console is to specify sync_default.conf file (see "Silent connection" section below)1) Browse for config file. Prior to connecting to MC, deliver the agent config file to the device.
2) Scan QR code. From MC UI show QR code when generating agent config and scan it with the phone.
3) Enter config manually. Manually fill in connection parameters, copy pasting is supported
- Console's address;
- Bootstrap token;
- Certificate fingerprint.
Recheck the connection parameters and apply:
Default path: is the directory where all folders will be stored per path macro
Management Console Address: the address where agent will be attempting to connect. If DNS is used, make sure it's resolved properly for this mobile.
Bootstrap token: used to authenticate agent on Management Console. Read more here.
Certificate fingerprint: the fingerprint of certificate used on Management Console.
Disable cert check: if "false", agent will check the fingerprint to ensure that it connects to the right MC.
If the connection is successful, the agent will appear in the list of agents on Management Console and will show connection details in Agent Settings-> Agent config section. From here one can disconnect the from Management Console
If connection failed for a reason, tap on the warning on top of agent UI and see connection details.
Go to Agent Settings-> Agent config, review connection parameters - address, bootstrap token or cert fingerprint, disconnect from that MC and try connecting again.
Silent connection & configuration
It is possible to place a configuration file to a predefined location so the Agent will load it upon first start and connect to the Management Console without asking user for connection details. Follow instructions below for silent connection.
- Generate
sync.conf
file on Management Console and rename it tosync_default.conf
- Deliver file to
/storage/emulated/0/
- Install the Agent APK or deploy it from Play Market
- Android 10 only, two options:
- allow access to the storage either through system settings -> Applications -> Resilio Connect Agent -> Permissions
- use ADB shell or an Android management software, and run these two commands before starting Resilio Connect Agent application:
pm grant com.resilio.connect.agent android.permission.WRITE_EXTERNAL_STORAGE pm grant com.resilio.connect.agent android.permission.READ_EXTERNAL_STORAGE
- Android 11 only, two options:
- allow access to the storage either through system settings -> Applications -> Resilio Connect Agent -> Permissions
- use ADB shell or an Android management software, and run these two commands before starting Resilio Connect Agent application:appops set --uid com.resilio.connect.agent MANAGE_EXTERNAL_STORAGE allow
- Run Agent app. It will pick up the file and attempt to connect to the Management Console without prompting a user
- Generate
sync.conf
file on Management Console and rename it tosync_default.conf
- Deliver file to
/storage/emulated/0/Android/data/com.resilio.connect.agent/files/
, create missing path components if necessary - Install the Agent APK or deploy it from Play Market
- Run Agent app. The Agent will pick up the file and attempt to connect to the Management Console without prompting a user