> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexxible.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Windows

FlexxAgent for Windows enables the monitoring, management, and automation of Windows devices from the Flexxible platform.

It is distributed as a single executable that integrates all the components needed for its operation, so it does not require any prior installation of dependencies or additional software.

This design simplifies deployment, update, and maintenance processes, especially in environments with a large number of managed devices.

## Compatibility

FlexxAgent is compatible with Windows versions that are within Microsoft's official support lifecycle:

* Microsoft Windows 10 or later.

* Microsoft Windows Server 2016 or later.

### Architecture requirements

FlexxAgent is only compatible with 64-bit operating systems. It cannot be installed on 32-bit systems.

## Architecture

FlexxAgent is distributed as a single executable. During installation, the components necessary for its execution are configured automatically at both the system and user session levels.

This architecture simplifies agent administration, streamlines diagnostic tasks, and reduces the operational complexity associated with its maintenance.

<img src="https://mintcdn.com/flexxible/PQntCI518hMI_3d-/images/flexxagent/univ-process.png?fit=max&auto=format&n=PQntCI518hMI_3d-&q=85&s=ab520005d2d094df35fef9ae5361c161" alt="univ-process" width="781" height="286" data-path="images/flexxagent/univ-process.png" />

## Resource consumption

FlexxAgent is optimized to minimize its impact on device performance. Approximate consumption values are as follows:

| Resource   | Approximate consumption |
| ---------- | ----------------------- |
| Disk space | \< 300 MB               |
| CPU        | \< 0.5 %                |
| RAM        | 90 - 170 MB             |

## Download and installation

1. Click **Download FlexxAgent**, available at the bottom of the side menu.
2. Select the reporting group that will be associated with the device.
3. Download the configuration file `(.conf)` and the Windows installer.

   The operating system may block files downloaded from the Internet. If this happens, they will need to be manually unblocked before starting the installation.

   <img src="https://mintcdn.com/flexxible/zA3m6tfe7aHVcynj/images/flexxagent/agent-download.png?fit=max&auto=format&n=zA3m6tfe7aHVcynj&q=85&s=8315a7776e8bd6bcabd1e4b479a0ab2f" alt="agent-download" width="750" height="553" data-path="images/flexxagent/agent-download.png" />

## Installer types

The advanced options let you select the installer format:

| Format | Description                                                                |
| ------ | -------------------------------------------------------------------------- |
| `.exe` | Recommended. Allows installations via a graphical interface or unattended. |
| `.msi` | Designed for unattended installations and automated deployments.           |

<img src="https://mintcdn.com/flexxible/PQntCI518hMI_3d-/images/flexxagent/wizard6.png?fit=max&auto=format&n=PQntCI518hMI_3d-&q=85&s=d433d53fd65df88d3e250a8979451039" alt="wizard6" width="749" height="220" data-path="images/flexxagent/wizard6.png" />

## Installation via graphical interface

To install FlexxAgent through the graphical interface:

1. Run the downloaded `.exe` file.

2. Read and accept the license agreement.

   <img src="https://mintcdn.com/flexxible/PQntCI518hMI_3d-/images/flexxagent/install_01-0.png?fit=max&auto=format&n=PQntCI518hMI_3d-&q=85&s=52d8cb0059cf6dfcb3067e023e54c290" alt="install_01-0" width="750" height="578" data-path="images/flexxagent/install_01-0.png" />

3. Select the configuration file `(.conf)` downloaded previously.

   <img src="https://mintcdn.com/flexxible/PQntCI518hMI_3d-/images/flexxagent/install_03-0.png?fit=max&auto=format&n=PQntCI518hMI_3d-&q=85&s=57cdfa63b3e83b834feef2cc31e3f015" alt="install_03-0" width="750" height="578" data-path="images/flexxagent/install_03-0.png" />

4. Click **Install** to start the installation process.

   <img src="https://mintcdn.com/flexxible/PQntCI518hMI_3d-/images/flexxagent/install_04-0.png?fit=max&auto=format&n=PQntCI518hMI_3d-&q=85&s=908c5afa57d39bd19c7247b48a8607b5" alt="install_04-0" width="750" height="578" data-path="images/flexxagent/install_04-0.png" />

## Unattended installation

FlexxAgent supports unattended installations using the downloaded files.

* Installer (`.exe` or `.msi`).
* Configuration file (`.conf`).

### Installation via EXE

#### Available parameters

| Parameter        | Type    | Required | Description                                                                                                                                                       |
| ---------------- | ------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/AgentConfig`   | String  | Yes      | For installations with a graphical interface, you will be prompted for the configuration value. To reuse a previous configuration, specify `/UsePrevConfig=True`. |
| `/UsePrevConfig` | Boolean | No       | When set to `True`, the installer attempts to reuse the existing configuration on the device. In this case, `/AgentConfig` does not need to be specified.         |
| `/SendTelemetry` | Boolean | No       | Default value: `False`.                                                                                                                                           |

#### Example

```powershell theme={null}
.\FlexxAgent.Installer.exe /verysilent /AgentConfig="C:\Path\To\Settings\settings.conf"
```

### Installation via MSI

#### Available parameters

| Parameter         | Type    | Required | Description                                                                                                                                               |
| ----------------- | ------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `AGENT_CONFIG`    | String  | Yes      | Absolute path to the configuration file (`.conf`). If you want to reuse a previous configuration, specify `USE_PREV_CONFIG=True.`                         |
| `USE_PREV_CONFIG` | Boolean | No       | When set to `True`, the installer attempts to reuse the existing configuration on the device. In this case, `AGENT_CONFIG` does not need to be specified. |
| `SEND_TELEMETRY`  | Boolean | No       | Default value: `False`.                                                                                                                                   |

### `msiexec` options

| Option | Description                                                     |
| ------ | --------------------------------------------------------------- |
| `/i`   | Installs the specified MSI package.                             |
| `/qn`  | Runs the installation in silent mode, with no user interaction. |

#### Example

```powershell theme={null}
msiexec /qn /i "C:\Path\To\Installer\FlexxAgent.Installer.msi" AGENT_CONFIG="C:\Path\To\Settings\settings.conf"
```

## Uninstallation

FlexxAgent can be uninstalled manually from the device's Control Panel.

To perform an unattended uninstallation, you can use the following methods.

### Uninstallation via EXE

```powershell theme={null}
"C:\Program Files\Flexxible\FlexxAgentUniversal\unins000.exe" /verysilent [/log="mi_fichero_de_log"]
```

### Uninstallation via MSI

```powershell theme={null}
msiexec /qn /passive /x "{6F330B47-2577-43AD-9095-18614A74D82F}"
```

## Connectivity test

The connectivity test lets you verify that FlexxAgent can communicate correctly with Flexxible services.

To run it, you need administrator permissions on the device.

### Steps to run the connectivity test

1. Open a console with administrator privileges.

2. Change to the installation directory:

   ```powershell theme={null}
   cd "%ProgramFiles%\Flexxible\FlexxAgentUniversal"
   ```

3. Run the following command:

   ```powershell theme={null}
   FlexxAgent.Universal.exe connectivity
   ```

4. Review the diagnostic information shown on the screen.

The output will include information about connectivity status and any possible communication errors with Flexxible services.

<img src="https://mintcdn.com/flexxible/JsQoT0tgTfYq-qwc/images/flexxagent/agent-conectivity.png?fit=max&auto=format&n=JsQoT0tgTfYq-qwc&q=85&s=1b1810628ebed51a23b9dea7815b8081" alt="agent-conectivity" width="1001" height="678" data-path="images/flexxagent/agent-conectivity.png" />

## Proxy configuration

If the environment uses a proxy server to access the Internet, the configuration must be done before installing FlexxAgent.

To do so, modify the downloaded configuration file (`.conf`) and add the `proxy` parameter to the `[Agent/Network]` section.

### Proxy without authentication

```ini theme={null}
proxy = http://proxy_uri:port
```

Example:

```ini theme={null}
proxy = http://192.168.0.100:443
```

### Proxy with authentication

```ini theme={null}
proxy = http://user:password@proxy_uri:port
```

Example:

```ini theme={null}
proxy = http://proxy_user:xxxxxxxx@192.168.0.100:443
```

## Magic link

<Note>
  Available only in FXXOne environments.
</Note>

The magic link lets users with the **Organization Administrator** role in partner-type organizations distribute the FlexxAgent installer without end users needing to sign in or authenticate on the platform.

The link is generated from the platform and can be shared with users to make it easier to download the agent directly onto their devices.

### Create a magic link

1. Go to **Home** from the platform menu.
2. Click **Generate a magic link**.

<img src="https://mintcdn.com/flexxible/fa81NqSTg_7uHzKB/images/flexxagent/magic-link.png?fit=max&auto=format&n=fa81NqSTg_7uHzKB&q=85&s=3136d1426ef3d5359159b6ab802ed76f" alt="magic-link" width="854" height="314" data-path="images/flexxagent/magic-link.png" />

3. Complete the form indicating:

   * The reporting group associated with the link.
   * The platform for which the installer is required.
   * The number of days during which the link will remain active.

   <img src="https://mintcdn.com/flexxible/fa81NqSTg_7uHzKB/images/flexxagent/magic-link-inst.png?fit=max&auto=format&n=fa81NqSTg_7uHzKB&q=85&s=f75d0585311b0b1da22f2bcadab46814" alt="magic-link-inst" width="1000" height="479" data-path="images/flexxagent/magic-link-inst.png" />

4. Click **New**.

5. Copy the generated link and click **OK**.

### Use a magic link

To use a magic link, simply copy it and paste it into the address bar of a web browser.

Once you access the link, the installer will start downloading and a confirmation page will be displayed.

<img src="https://mintcdn.com/flexxible/Bu8f4dI-plc_yf8g/images/flexxagent/magic-ling-downloaded.png?fit=max&auto=format&n=Bu8f4dI-plc_yf8g&q=85&s=0a390aaad684cc08e8d20a7e820c6bdb" alt="magic-ling-downloaded" width="854" height="380" data-path="images/flexxagent/magic-ling-downloaded.png" />

### Revoke a magic link

1. Go to **Settings** → **Reporting groups**.
2. In the **Action** column of the reporting group, select the **Revoke** option.
3. Confirm the action by clicking **OK**.

Once revoked or expired, a magic link cannot be used again.
