Installation

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

Configuring Package Sources (apt, dnf, rpm)

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

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

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

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

Using dnf (RHEL, Fedora, Rocky Linux):

sudo dnf install odigos

Using apt (Debian, Ubuntu):

sudo apt install odigos

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.

​Configuring Package Sources (apt, dnf, rpm)

​Installation

​Installing the license token for the vm-agent

​Enabling the Odigos OpenTelemetry Collector and VM Agent service

Configuring Package Sources (apt, dnf, rpm)

Installation

Installing the license token for the vm-agent

Enabling the Odigos OpenTelemetry Collector and VM Agent service