Manage Device Agent

What is the Device Agent?

The Device Agent is a program that runs on your computer and applies the policies defined in Subrosa to protect you while using AI tools.

It can see your traffic to AI providers (but only AI providers) and applies the defined policies and their corresponding actions transparently, you won't know it is there unless it takes an action.

The agent is built to be privacy respecting, it only looks at traffic to a defined set of AI providers and never sends data off your device.

It is also very light on system resources.

Create a Device Agent

You can create a Device Agent from the Device Agent page. A valid device contact email needs to be provided at this step.

Downloading the Device Agent

Follow the download links on the Device Agent page for your Operating System.

Having trouble downloading the Device Agent? Contact us at help@subrosa.ai

Install the Device Agent

See Installation Steps.

Authenticate the Device Agent

See Authentication Steps.

Update the Device Agent

See Updating the agent.

Delete Device Agent

You can delete a Device Agent from the Device Agent List through the option menu next to a Device Agent item.

This will remove it from Subrosa, it will no longer be able to send data.

To remove it from your local machine:

  1. Open a Terminal (see here if you do not know how)

  2. Type sr-agent uninstall and hit <enter>

  3. Follow the prompts

Stop the Device Agent Process on Device

If you want to stop the agent on your local device without unlinking it

The agent integrates with the process managers of the operating systems we support, so you will be interacting with these to control its lifecycle

  • On Windows that is the Windows Service Manager and its frontend sc

  • On Mac that is launchd and its frontend launchctl

  • On Linux that is systemd and its frontend systemctl

  1. Windows

    1. Open a Terminal as an Administrator

      1. Press the Windows Start button at the bottom left

      2. Type in "Command Prompt"

      3. Right click on Command Prompt and click "Run as administrator"

      4. Click Yes if the Windows 10 User Account Control prompt is displayed

    2. Type sc stop SubrosaService and hit <enter>

      1. It can be restarted with sc start SubrosaService

  2. Mac

    1. Open a Terminal

    2. Type sudo launchctl stop ai.subrosa.service and hit <enter>

      1. It can be restarted with sudo launchctl start ai.subrosa.service

  3. Linux

    1. Open a Terminal

    2. Type sudo systemctl stop subrosa and hit <enter>

      1. It can be restarted with sudo systemctl start subrosa

PreviousStep 3 - Monitor AI UsageNextOrganisation Dashboard

Last updated