# Install INSIGHT Agent

## System Requirements

Before installing the GuardWare INSIGHT Agent, ensure your system meets the minimum specifications. Meeting these prerequisites ensures smooth installation, stable performance, and proper communication with the INSIGHT Management Console.

<table><thead><tr><th width="255">Component</th><th>Minimum Requirement</th></tr></thead><tbody><tr><td>Processor</td><td>Dual-core processor or higher</td></tr><tr><td>Memory (RAM)</td><td>8 GB</td></tr><tr><td>Disk Space</td><td>500 MB free space</td></tr><tr><td>Operating System</td><td>Microsoft Windows 8.x, Windows 10 or later</td></tr></tbody></table>

## Whitelist GuardWare INSIGHT

To ensure the GuardWare INSIGHT Agent installs and functions correctly, you need to configure antivirus exclusions. For details, see [Whitelist GuardWare INSIGHT](/insight/guardware-insight/getting-started/whitelist-guardware-insight.md).

## Install GuardWare INSIGHT Agent Manually

The GuardWare INSIGHT Agent can be installed manually on individual endpoint devices. This process involves running the GuardWare INSIGHT Agent installer directly on each device and completing a simple setup wizard.

{% hint style="info" %}
The Agent installer file size is approximately 60 MB.
{% endhint %}

To install GuardWare INSIGHT Agent manually:

1. Double-click the GuardWare INSIGHT Agent installer file to begin the installation.
2. In the **Setup Wizard**, click **Next** to continue.

<div align="left"><img src="/files/1b83320edff1ecef48de1fe12e8ceb3ab2bdb9b5" alt="" width="563"></div>

3. Choose the folder where you want to install the GuardWare INSIGHT agent and click **Next**. By default, the agent will be installed in: `C:\Program Files\`.

<div align="left"><img src="/files/1c7599c89c2a4de8451cf7a554ca218050fced8b" alt="" width="563"></div>

4. Click **Install** to begin the installation. The installation may take a few minutes to complete.

<div align="left"><img src="/files/b18d94988260c463d89d089383205883a2582a0a" alt="" width="563"></div>

During installation, a User Account Control (UAC) dialog box may appear. This is a standard Windows security feature that verifies whether you want to allow the installer to make changes to your computer. When this dialog appears:

1. Verify that the publisher is GuardWare Australia Pty Ltd.
2. Click **Yes** to allow the installation to proceed. Clicking **No** cancels the installation.
3. Once the installation is complete, click **Finish** to exit the wizard.

## Install GuardWare INSIGHT Agent Using Active Directory

You can deploy GuardWare INSIGHT Agent to multiple computers simultaneously using **Active Directory (AD)** Group Policy. This method automates installation across all devices within the selected organisational units (OUs), ensuring consistent configuration and minimal manual effort.

To install GuardWare INSIGHT Agent using AD:

1. On the **Active Directory Server**, click **Start** > **Run**.

<div align="left"><img src="/files/e45132ca156af5e551db39268668762c963f456a" alt=""></div>

2. In **Active Directory Users and Computers**, create a new **Organisational Unit (OU)** and give it a name, for example, *Install GW INSIGHT Agent*. Creating a separate OU ensures the deployment policy does not conflict with existing group policies.
3. In the **Group Policy Management Console**, right-click the new OU and select **Create and Link a GPO Here**.
4. Enter a descriptive name for the policy, such as *GW INSIGHT Agent* *Installation*, and click **OK**. Once created, the same GPO can also be linked to other OUs if required.

<div align="left"><img src="/files/6ad18bf60910487e55d2658b6c9a21785cc5e0a0" alt="" width="375"></div>

5. Right-click the new GPO and select **Edit** to open the **Group Policy Object Editor**.

<div align="left"><img src="/files/c9d40f1a7176acc8740aaea6e3f9240fbd55417b" alt="" width="563"></div>

6. In the editor, expand **Computer Configuration > Software Settings > Software Installation**.
7. Right-click **Software Installation**, select **New > Package**, and browse to the MSI file for the GuardWare INSIGHT Agent.

<div align="left"><img src="/files/0e410765774d10d9eeda48bd08f54d0d2da7abc3" alt="" width="375"></div>

8. Enter the package path using the **FQDN (Fully Qualified Domain Name)** format, for example, `\\DC01\client\client.msi`, where `DC01` is your domain controller name and `client` is the shared folder containing the MSI installer.
9. Select the package and click **Open** to add it to the policy.
10. Close the **Group Policy Object Editor** once the package has been added.
11. In the **Group Policy Management Console**, confirm that the new GPO is listed under **Linked Group Policy Objects** for the selected OU.
12. Close the **Group Policy Management** window.
13. Click **Start > Run**, type `gpupdate /force`, and click **Ok** to refresh the Group Policy settings and apply the new configuration.

Once the Group Policy is updated, the GuardWare INSIGHT Agent will automatically install on all computers within the selected Organisational Unit the next time they start or update their policies.

## Install GuardWare INSIGHT Agent Using Microsoft Intune

You can deploy GuardWare INSIGHT Agent across multiple endpoint devices using Microsoft Intune. This method enables centralised and automated installation of the client on enrolled Windows devices, ensuring consistent deployment across your organisation.

To install GuardWare INSIGHT Agent using Microsoft INTUNE:

1. Sign in to the [**Microsoft Intune Admin Center**](https://intune.microsoft.com/) using your administrator account.
2. From the left navigation menu, navigate to **Apps > All apps**.

<div align="left"><img src="/files/54c2d884d1e3e091bf68b5f80ed857aeb2ddf80f" alt="" width="375"></div>

3. Click **+ Create** to create a new application.

<div align="left"><img src="/files/f1b407a0a55ad4800dc64cab34fa402a93f5e38b" alt="" width="563"></div>

4. Under **Select app type**, choose **Line-of-business app**, and click **Select**.

<div align="left"><img src="/files/80506263e782f53ebdbbd8c09d85fe24694bee27" alt="" width="375"></div>

5. In the **App information** section, click **Select app package file**, then browse and upload the GuardWare INSIGHT Agent installer file.

<div align="left"><img src="/files/ad5dbcb27b9473a7a3b4fd34c941a8166b559c25" alt="" width="375"></div>

6. After the file is uploaded, review the app details and click **OK**.
7. Configure the following information in the **App information** section and click **Next**.
   * **Name:** Enter a display name of the application that appears in Intune and on endpoint devices during installation.
   * **Description:** Enter a description for the application.
   * **Publisher:** Enter the publisher’s name.

     <div align="left"><img src="/files/49b6e431620a583908809d6494fc1ec64f204b48" alt="" width="563"></div>
8. In the **Assignments** tab, specify which devices or user groups should receive the application.
   * Under **Required**, click **Add group** and select the **Azure AD device groups** or **user groups** where the GuardWare INSIGHT Agent should be installed automatically.

     <div align="left"><img src="/files/cdb60d62ab495e32077ed22a9bbcebff4227ae9a" alt="" width="563"></div>
9. Click **Next**, review the configuration summary, and click **Create** to publish the deployment.

<div align="left"><img src="/files/8e7e29ae6d6ffccf1bae7b8309a2fc6a893eda3f" alt="" width="563"></div>

Once deployed, the **GuardWare INSIGHT Agent** will automatically install on all assigned devices the next time they check in with Intune. You can monitor the installation progress under *Apps > Monitor > Installation* status in the Intune Admin Center.

## Install GuardWare INSIGHT Agent Using PDQ Deploy

You can deploy the **GuardWare INSIGHT Agent** to multiple endpoint devices simultaneously using **PDQ Deploy**, a software deployment tool designed for centralised and silent installations. PDQ Deploy enables IT administrators to automate agent installation across the network without requiring any pre-installed agent on target machines.

#### Create a New Deployment Package

1. Open **PDQ Deploy**.
2. Click the **New Package** (📦) icon to create a new deployment package.
3. In **Package Properties**, fill in the following details:
   * **Name:** GuardWare INSIGHT Agent
   * **Version:** (enter the current agent version, e.g. 1.0.0)
   * **Run As:** Local System
   * **Description:** Installs the GuardWare INSIGHT Agent on endpoint devices.

     <div align="left"><img src="/files/ae83ada56eebe91d8f1824b35a35e2e4e6d63b05" alt="" width="563"></div>
4. Click **Step 1** to define the installation command.
5. In **Install File**, select the GuardWare INSIGHT Agent installer file.
6. In **MSI Options**, configure the following:
   * **Operation:** Install
   * **Restart:** Never
   * **Quiet:** Yes (this ensures a silent installation with no user prompts).

     <div align="left"><img src="/files/32ae30f7cd76496dc015226d261a053c7b9cf465" alt="" width="563"></div>
7. Click the **Save** icon (💾) to save the package configuration.

#### Deploy the Agent

1. In PDQ Deploy, click **Deploy > Deploy Once**.
2. Click **Edit Credentials** > **Add Credentials** to set or edit the administrator credentials for deployment.

<div align="left"><img src="/files/7df2c5b50b12828fdcb6cd159ff7eb4926c3a7ae" alt="" width="563"></div>

3. Enter the **Domain, User Name** (administrator account), **Password,** and click **Test Credentials** to verify access, then click **OK**.

<div align="left"><img src="/files/371652c484bb92781dc7046a62362a0135e8baa8" alt="" width="563"></div>

4. Add the target computers for deployment:
   1. You can specify devices using either their **PC Name** or **IP Address**.
   2. Click **Add Computer** after entering each one.<br>

      <div align="left"><img src="/files/0d37fc0d37b311f1b635678360c2596c7614945f" alt="" width="563"></div>
5. Select the appropriate **Credentials** and ensure **Run as Local System** is set to **Yes**.
6. Click **Deploy Now** to start the installation.

<div align="left"><img src="/files/b0669001a0acf99900bdbf673832c3dbd08c3b51" alt="" width="563"></div>

PDQ Deploy will perform the following actions automatically:

* Copy the GuardWare INSIGHT Agent installer file to each target machine.
* Run the installation silently in the background.
* Display real-time status updates for each target device.

Once deployment is complete, the status will display as **Successful** for each device where the installation finished.

<div align="left"><img src="/files/f42c7895571fb6acfe01cafbd986b352cb86349b" alt="" width="563"></div>


---

# 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.guardware.com/insight/guardware-insight/getting-started/install-insight-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.
