# How to Deploy the Windows Agent

**Overview**

The BoolDesk Agent is a lightweight software client that runs on your organization's computers. Once installed, it automatically communicates with the BoolDesk server to report hardware specifications, installed software, and system status. Installing the agent is the primary way to populate your asset inventory with accurate, real-time data.

#### **Step-by-Step Guide**

**1. Access the Agent Download Menu**

To find the installation script, you can use the Quick Action menu from anywhere in the platform.

* Click the plus icon (+) (1) located in the top header of the application.
* From the quick create menu, locate the agent section on the right side.
* Click on Windows Agent (2).

<figure><img src="/files/QlJrk93t4toPnVCQQ7TK" alt=""><figcaption></figcaption></figure>

**2. Copy the Installation Script**

A "Windows Agent – Setup Script" window will appear. This window provides a pre-configured PowerShell script that handles the entire installation process, including downloading the installer and connecting it to your specific BoolDesk instance with the correct tokens.

* Review the Script: The script includes your specific API URLs (`AGENTAPIEXTERNALBASEURL`, etc.), your `ENROLLMENTTOKEN`, and your unique `TENANTID`.
* Copy: Click the copy icon in the top right corner of the black code block to copy the full command to your clipboard.

**3. Run the Script on the Target Machine**

To complete the installation:

1. Log in to the Windows computer you want to manage.
2. Open PowerShell as an Administrator.
3. Paste the command you copied in the previous step.
4. Press Enter to run it.

The script will automatically download the `BoolDeskAgent.msi` file, install it silently, and register the computer in your BoolDesk inventory.

<figure><img src="/files/TJCp6o3PruaRO5sr0fYP" alt=""><figcaption></figcaption></figure>


---

# 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.booldesk.com/how-to-configure-settings/system-settings/how-to-deploy-the-windows-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.