Using remote control with agent
This page describes how to use the remote agent to connect with remote control
Last updated
Was this helpful?
This page describes how to use the remote agent to connect with remote control
Last updated
Was this helpful?
The is designed to be deployed in a way that is more secure and easier to manage at scale than the regular or instances. When the agent is running, it does not have any way to interact with it from the local machine.
On the very first run, the Agent will attempt to register itself with the Duplicati Console. If there is a desktop environment and a browser on the system, the Agent will attempt to open this with . In case there is no such option, the Agent will print out the link in the console or Event Viewer on Windows. The Agent will repeatedly poll the Console to find out when it is claimed.
As long as the Agent is not registered, restarting it will make it attempt to connect again.
Once the agent is registered, it immediately enables the connection and will be listed as a registered machine in the .
Any machine can now use this pre-authorized url to add machines to your organization in the Console. You can click the "Copy" button to get the link to your clipboard and paste it in when registering a machine. Do not share this link with anyone as it could allow them to add machines to your account.
To revoke a link, simply delete it from within the portal. This will prevent new machines from registering, but existing registered machines will remain there.
With the registration link, start the Agent with a commandline such as:
This will cause the Agent to immediately show up in the Console. Future invocations of the agent will not require the registration url, but should the Agent somehow be de-registered, it will re-reregister if the url is set and the link is still valid.
To skip the registration step and have the agent connect directly to the console without any user intervention, it is required to first create a link that is pre-authorized on the Console. To do this head to the and click the "Add registration url" button.
To simplify starting the agent in larger scale deployments, it is possible to configure with the registration url. To do so, create a file named preload.jsonwith the following content:
This file can then be distributed to the target machine before the package is installed. The describes the possible locations where Duplicati will look for such a file.
