> ## Documentation Index
> Fetch the complete documentation index at: https://odigos-cursor-browser-instrumentation-security-2830.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# System Requirements

> To ensure optimal performance and compatibility when deploying the Odigos VM Agent, your environment must meet the following system requirements.

<Note>
  Odigos eBPF-based data collection requires, at minimum, platforms that have underlying Linux kernel versions of 5.4.0.

  The required Linux capabilities depend on your kernel version:

  * **Kernel 5.4 – 5.7**: requires `CAP_SYS_ADMIN`.
  * **Kernel 5.8 and later**: requires `CAP_BPF` and `CAP_SYS_PTRACE`.

  We recommend running on kernel 5.8 or later when possible, as the more granular capabilities (`CAP_BPF` and `CAP_SYS_PTRACE`) follow the principle of least privilege compared to `CAP_SYS_ADMIN`.
</Note>

* Odigos Pro license key (or token) for the VM Agent.
* A Linux host, plus deployment-specific requirements:
  * **[Package installation](/vmagent/setup/installation)** — a RHEL-compatible
    distribution (DNF), a Debian-based distribution (APT), or any Linux system
    supporting RPM packages.
  * **[Docker deployment](/vmagent/setup/docker)** — Docker installed and
    running, with permission to start privileged containers. See also the
    [required permissions](/vmagent/setup/docker#required-permissions) on that
    page.
  * **[Amazon ECS](/vmagent/ecs/overview)** — an ECS cluster on the **EC2**
    launch type (Fargate is not supported) with container instances on kernel
    5.10+ with BTF. See the
    [ECS system requirements](/vmagent/ecs/requirements) for the full list.
* At least one process or application on the host that is written in a
  [supported language](/enterprise/instrumentations/overview).

## Disk space

The host must provide the following minimum free disk capacity. If these paths
share a filesystem, the combined free space must meet the sum of the individual
requirements.

<Note>
  These values are planning estimates based on typical agent usage and may
  change in future releases. Size `/tmp` according to your diagnose bundle
  configuration if you raise the default bundle size.
</Note>

| Path   | Minimum free | Purpose                                                                           |
| ------ | ------------ | --------------------------------------------------------------------------------- |
| `/var` | 500 MB       | Instrumentation tools and agent logs                                              |
| `/usr` | 500 MB       | Agent binaries and packages                                                       |
| `/etc` | 2 MB         | Agent configuration                                                               |
| `/tmp` | 55 MB        | Diagnose bundle generation (50 MB default bundle size) and temporary files (5 MB) |
