> For the complete documentation index, see [llms.txt](https://docs.thousandeyes.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thousandeyes.com/product-documentation/connected-devices/device-agents/getting-started/system-requirements.md).

# System Requirements

Before you install the agent, review the requirements and recommendations for your device's operating system, hardware, storage, memory, and network access.

## Operating System and Kernel

* Linux 4.4 or later is recommended for speeds up to 1 Gbps.
* Linux 4.14 or later is recommended for multi-gigabit targets.
* Linux 5.10 or later provides the best baseline for 10 Gbps.

## CPU Architecture

| Delivery     | Supported architectures                     |
| ------------ | ------------------------------------------- |
| TAR archives | ARMv7, ARM64, MIPS, MIPSEL, and x86-64      |
| OpenWrt feed | ARMv7, ARM64, MIPS, MIPSEL, x86, and x86-64 |
| Containers   | ARM64 and x86-64                            |

## Storage, Memory, and Update Management

Storage requirements depend on the update model and whether you install the agent in RAM or on persistent storage.

Choose an update model, then check the available memory on your device.

{% hint style="info" %}
**Recommended Update Model**

Use the Agent Updater unless you already deploy third-party applications independently of firmware or your policies prohibit Agent Updater installations.
{% endhint %}

| Update model               | Install       | Responsibility                                                                                                                                                                                 |
| -------------------------- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Managed via ThousandEyes   | Agent Updater | The Agent Updater retrieves approved agent releases. It launches and supervises the agent but does not update itself. Your firmware or provisioning process updates the Agent Updater package. |
| Self-managed agent updates | Agent-only    | Your firmware release process packages, distributes, restarts, and validates each agent release.                                                                                               |

With the Agent Updater, installing the agent in `/tmp` reduces flash use but uses RAM. Agent-only installations store the agent on persistent flash.

| Update model  | Agent install location                  | Recommended persistent storage | Recommended RAM (at 1 Gbps / 10 Gbps) |
| ------------- | --------------------------------------- | ------------------------------ | ------------------------------------- |
| Agent Updater | agent under `/tmp`                      | 10 MiB                         | 60 MiB / 85 MiB                       |
| Agent Updater | Persistent storage (read-write overlay) | 25 MiB                         | 50 MiB / 70 MiB                       |
| Agent-only    | Persistent storage (read-write overlay) | 15 MiB                         | 50 MiB \*                             |

* For agent-only installations at speeds up to 10 Gbps, check RAM for each device model.

The agent caches measurement data locally when it cannot submit results to the ThousandEyes platform. It submits cached data when connectivity returns. The cache holds up to 2 MB of data for up to 24 hours.

## Hardware Acceleration

During a speed test, the agent selects the best available measurement backend. Some multi-gigabit devices need silicon-specific acceleration to reach higher speeds. Other devices have enough processing power to reach those speeds without acceleration.

To identify the backend the agent uses, check the `Speed backend` output in [self-test mode](https://docs.thousandeyes.com/product-documentation/connected-devices/device-agents/validation-and-troubleshooting/validate-with-self-test-mode.md).

The table lists backends the agent can use and the requirements for each. The listed SoCs are examples, not a complete compatibility list. If your device needs an accelerator that isn’t listed, contact ThousandEyes to confirm support.

| Measurement backend                                         | Example SoCs             | Requirements                            |
| ----------------------------------------------------------- | ------------------------ | --------------------------------------- |
| `broadcom-htoa-fro` / `broadcom-htoa-enhanced-software-gso` | BCM491x, BCM6766         | Requires a bp3 license                  |
| `broadcom-bspeed`                                           | BCM3390                  | Contact ThousandEyes for a custom agent |
| `broadcom-spdt`                                             | BCM6858x                 | Contact ThousandEyes for a custom agent |
| `qualcomm-socket-offload`                                   | IPQ53x2 (Miami)          | Requires QSDK 13.1+                     |
| `qualcomm-nss-udp`                                          | IPQ5018 (Maple), IPQ807x | Contact ThousandEyes for a custom agent |

If measured speeds are lower than expected, see [Speed Quick Wins](https://docs.thousandeyes.com/product-documentation/connected-devices/device-agents/validation-and-troubleshooting/speed-quick-wins.md).

For an overview of TCP speed-test capabilities and validation guidance, see [TCP Speed Tests](https://docs.thousandeyes.com/product-documentation/connected-devices/device-agents/configuration/tcp-speed-tests.md).

## Agent Updater and Network Access

The Agent Updater activates the device, obtains the device's unique identifier (Unit ID), and downloads approved agent packages. It verifies each package's Cisco CMS signature before it installs and launches the agent, then supervises the agent. Allow the applicable ports for the Agent Updater, DNS and time services, and RealSpeed discovery:

| Component           | Direction         | Port       | Purpose                                                       |
| ------------------- | ----------------- | ---------- | ------------------------------------------------------------- |
| Agent Updater       | Outbound          | TCP 443    | Activation, update checks, package downloads, and reporting   |
| Device DNS resolver | Outbound or local | UDP/TCP 53 | Resolves hostnames for ThousandEyes services and test targets |
| Device time service | Outbound          | UDP 123    | Synchronize time when the platform uses NTP                   |
| agent               | Inbound from LAN  | UDP 5353   | RealSpeed mDNS discovery when enabled                         |

The Agent Updater does not require an inbound port. Assigned tests determine the measurement traffic the agent sends.

### Agent Test Traffic

The agent initiates test connections. For each assigned test, allow traffic to its destinations on the required protocols and ports, including connections to on-net test servers.

| Function                             | Direction                  | Protocol and port                      | Notes                                                                                                                                                                                             |
| ------------------------------------ | -------------------------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| agent services                       | Outbound, with replies     | TCP 443                                | Retrieve schedules and report results and logs                                                                                                                                                    |
| Ping and path measurements           | Outbound, with replies     | ICMP                                   | Allow related replies and ICMP error messages                                                                                                                                                     |
| HTTP tests                           | Outbound, with replies     | TCP 80, 443, or configured port        | Depends on the test target                                                                                                                                                                        |
| DNS tests                            | Outbound, with replies     | UDP/TCP 53 or configured port          | Depends on the configured DNS target                                                                                                                                                              |
| Latency and disconnection monitoring | Outbound, with replies     | UDP 6000 by default                    | The schedule can specify another port                                                                                                                                                             |
| Jitter                               | Outbound, with replies     | UDP 6003 by default                    | Test settings can specify a different port                                                                                                                                                        |
| TCP speed                            | Outbound, with replies     | TCP 6500 by default                    | The test-server configuration can override this                                                                                                                                                   |
| UDP speed                            | Outbound, with replies     | TCP 8000 control; UDP 8001 measurement | The test-server configuration can override these ports                                                                                                                                            |
| Application tests                    | Outbound, with replies     | Depends on the application and target  | Gaming, video conferencing, and other suites use target-specific ports. See [Test Settings](https://docs.thousandeyes.com/product-documentation/connected-devices/test-management/test-settings). |
| RealSpeed discovery                  | Inbound from the local LAN | UDP 5353                               | This port is required only when local discovery is enabled                                                                                                                                        |

Continue to [Embedded Linux quick install](https://docs.thousandeyes.com/product-documentation/connected-devices/device-agents/getting-started/embedded-linux-quick-install.md).
