# Step 1 - Install Device Agent

## Creating Device Agent

In the Subrosa web application:

1. Click on `Device Agent` in the sidebar
2. Click `Create Device Agent`
3. Provide the required information and click `Confirm`

## Downloading the Device Agent

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

{% hint style="warning" %}
Having trouble downloading the Device Agent? Contact us at <help@subrosa.ai>
{% endhint %}

## Install the Device Agent

Once you have downloaded the file

1. Unzip the installer
   1. Double click the downloaded file and follow your Operating Systems instructions to extract the contents
2. Run the installer

{% hint style="warning" %}
If you find you do not have permission to run new programs on your organisation managed device you will need to contact your technical support or IT team for assistance.
{% endhint %}

## Authenticate the Device Agent

1. Open a Terminal on your machine
   1. Guide for [Windows](https://learn.microsoft.com/en-us/windows/terminal/) Terminal
   2. Guide for [Mac](https://support.apple.com/en-au/guide/terminal/trmlb20c7888/mac) Terminal
   3. Linux (use your preferred Terminal Emulator)
2. Copy the command line from the `Create Device Agent` page, enter it into the terminal and press \<enter>.&#x20;
   1. Alternatively, you can also find the agent from the list on the `Device Agent` page, and click on option menu to retrieve authentication command line.
3. You will see a success message after authentication in your Terminal, once you see it you can close the Terminal

Subrosa is now installed and protecting your machine!

{% hint style="warning" %}
Having trouble? Contact us at <help@subrosa.ai>
{% endhint %}

## Update the Device Agent

We send an email to all customers when a new version of the agent is released, to update to the new version repeat the installation steps above. The installer will see and keep your existing settings so you won't need to authenticate again.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.subrosa.ai/getting-started/step-1-install-device-agent.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.