System Requirements

Odigos Pro license key (or token) for the VM Agent. Apply it after install with sudo odictl -odigos-license '<JWT>' — see Installation.
A Linux host, plus deployment-specific requirements:
- Package installation — a RHEL-compatible distribution (DNF), a Debian-based distribution (APT), or any Linux system supporting RPM packages.
- Docker deployment — Docker installed and running, with permission to start privileged containers. See also the required permissions on that page.
- Amazon ECS — 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 for the full list.
At least one process or application on the host that is written in a supported language.

Kernel and systemd

Odigos eBPF-based data collection requires Linux kernel 5.4 or later. Prefer 5.8 or later when possible. Non-root mode (the package default) additionally requires systemd 229 or later, which is when AmbientCapabilities= became available. On older systemd the installer runs the agent as root, even if you request non-root.

Distro	Typical kernel	systemd	Default agent mode
RHEL 7, CentOS 7, Amazon Linux 2	3.10 / 4.14	219	Root only (`AmbientCapabilities` unavailable)
RHEL 8, Rocky 8	4.18	239+	Non-root
RHEL 9, Rocky 9, Amazon Linux 2023	5.14+	250+	Non-root
Debian 11–13, Ubuntu 20.04+	5.4+	245+	Non-root

Confirm what this host can grant:

/usr/lib/odigos/bin/odigos-vmagent-caps --explain

Expected output:

systemd version      : 257
kernel               : 6.12.0-211.46.1.el10_2.x86_64
ambient capabilities : supported
capability set       : CAP_SYS_ADMIN CAP_SYS_PTRACE CAP_DAC_READ_SEARCH CAP_SYSLOG CAP_CHOWN CAP_DAC_OVERRIDE CAP_FOWNER CAP_NET_RAW CAP_NET_ADMIN CAP_SETUID CAP_SETGID

The non-root capability set is the same on every distro and always includes CAP_SYS_ADMIN. It does not switch to CAP_BPF / CAP_PERFMON on newer kernels. See Linux Permissions for the full list, why each bit is required, and how to add or remove capabilities.

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.

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.

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)

​Kernel and systemd

​Disk space

Kernel and systemd

Disk space