Installation

Install the Odigos VM Agent on your Linux host

The Odigos VM Agent is available as part of Odigos Pro. For access and licensing details, contact us.

This page installs the VM Agent as a Linux system package. To run the agent as a container instead — for example on immutable hosts or Compose-managed fleets — see Docker Deployment.

Configuring Package Sources (apt, dnf, rpm)

To install the Odigos VM Agent, configure your package manager or obtain the RPM files.

DNF

Using dnf (RHEL, Fedora, Rocky Linux):

sudo rm /etc/yum.repos.d/odigos.repo
sudo tee /etc/yum.repos.d/odigos.repo > /dev/null <<'EOF'
[odigos]
name=Odigos Packages
baseurl=https://yum.odigos.io/projects/odigos-cloud/odigos-rpm
enabled=1
gpgcheck=0
repo_gpgcheck=0
EOF

sudo dnf makecache

APT

Using apt (Debian, Ubuntu):

sudo mkdir -p /etc/apt/keyrings/

wget -q -O - https://apt.odigos.io/doc/repo-signing-key.gpg \
  | gpg --dearmor \
  | sudo tee /etc/apt/keyrings/odigos.gpg > /dev/null

echo "deb [signed-by=/etc/apt/keyrings/odigos.gpg] https://apt.odigos.io/projects/odigos-cloud odigos-apt main" \
  | sudo tee /etc/apt/sources.list.d/odigos.list

sudo apt update

RPM

If you use a package manager other than dnf or apt, or prefer to install via RPM files, you can install the VM Agent using RPM files. There are two files you will need to obtain:

• odigos-otelcol-<otelcol-version>.rpm
• odigos-<agent-version>.rpm

Obtain the rpm files from your Odigos support team

Installation

DNF

Using dnf (RHEL, Fedora, Rocky Linux):

sudo dnf install odigos

APT

Using apt (Debian, Ubuntu):

sudo apt install odigos

RPM

If you use a package manager other than dnf or apt, run the following to install the agent:

Replace <otelcol-version> and <agent-version> with the versions you downloaded.

rpm -ivh odigos-otelcol-<otelcol-version>.rpm odigos-<agent-version>.rpm

Installing the license token for the vm-agent

Write the license token received from the Odigos support team to the file /etc/odigos-vmagent/license.jwt

echo "<license-token>" | sudo tee /etc/odigos-vmagent/license.jwt

Enabling the Odigos OpenTelemetry Collector and VM Agent service

Once the installation is complete, enable the VM Agent service to start automatically on system startup:

sudo systemctl enable --now odigos-otelcol.service
sudo systemctl enable --now odigos-vmagent.service

If you run Odigos Central, follow Connecting VM Agent to link this host to Central.