Skip to content

Run the Agent service as a different user

By default, the Resilio Active Everywhere Agent service runs under the Local System account on Windows (applicable to Resilio Active Everywhere 5.1 and older) and rslagent user on Linux (when installed via a package manager). You can configure it to run under a different account.

Windows

Note

Applicable to Resilio Active Everywhere 5.1 and older.

To run the Resilio Agent as a different user on Windows:

  1. Grant Full control permissions to the user account on the storage folder and the installation folder.
  2. Open the Services management console (services.msc).
  3. Locate and right-click the Resilio Connect Agent Service service, then select Stop.
  4. Right-click the Resilio Connect Agent Service service again and select Properties.
  5. In the Log On tab, select This account and enter the credentials of the user account you want the service to run under, then click OK.
  6. Click Start to start the service with the new user account.

Linux

By default, the Resilio Agent installed via a package manager, runs under the rslagent user. You can configure it to run under a different account.

To run the Resilio Agent as a different user on Linux distributions with the systemd service manager, proceed as follows:

  1. (Optional) Create a user and group to run the Resilio Agent service:

    $ sudo groupadd -r resilioAgentService  
    $ sudo useradd -g resilioAgentService -r -m -s /sbin/nologin resilioAgentService
    
  2. Stop the Resilio Agent service:

    sudo systemctl stop resilio-agent
    
  3. Navigate to /etc/systemd/system/resilio-agent.service.d (create the directory if it doesn't exist), and create the override.conf file.

  4. Edit the override.conf file and add the following:

    [Service]  
    User=resilioAgentService
    Group=resilioAgentService
    Environment="AGENT_USER=resilioAgentService"
    Environment="AGENT_GROUP=resilioAgentService"
    
  5. Reload the unit files:

    sudo systemctl daemon-reload
    
  6. Start the Resilio Agent service:

    sudo systemctl start resilio-agent