Integration · Deploys and install

Install the Opservo agent with Ansible

Install the Opservo agent on every Linux host with the Ansible Galaxy role opservo.opservo_agent: idempotent, uses the signed installer, never logs keys.

In short

The Ansible Galaxy role opservo.opservo_agent installs the Opservo agent on every Linux host in your inventory with the official installer, so the binary is checked against Opservo’s signed manifest exactly as in a manual install. The role is idempotent, keeps your enrollment key out of logs, and hosts appear in your workspace within a minute.

What you get

One playbook run puts the whole fleet under monitoring.

  • ansible-galaxy role install opservo.opservo_agent.
  • Idempotent: hosts that already have the agent are only checked to be enabled and running.
  • The installer task runs with no_log, so the key never appears in output.
  • Works on systemd hosts: Ubuntu, Debian, RHEL, Rocky, Alma and Amazon Linux, with Ansible 2.14 or newer.

How to set it up

Create a fleet key in Opservo, keep it in Ansible Vault, and run the role.

  1. In Opservo, open Add server → Auto Scaling / golden AMI → Create fleet key. A fleet key is multi-use and revocable.
  2. Store it with ansible-vault encrypt_string as vault_opservo_enroll_key.
  3. Add the role to a play with become: true and opservo_agent_enroll_key set from the vault, then run the playbook.

Good to know

  • The role does not switch on remote actions. Every server stays read-only until an owner or admin turns actions on for it in the dashboard.
  • The agent updates itself from signed releases, so you do not need to re-run the role to upgrade.

Ansible and Opservo, answered

Is there an Ansible role for Opservo?+

Yes: opservo.opservo_agent on Ansible Galaxy. It installs the agent with the official signed installer and is safe to run repeatedly.

Which enrollment key should I use with Ansible?+

A fleet key (fleet_…), created under Add server → Auto Scaling / golden AMI. It enrolls many hosts and can be revoked; a single-use token enrolls only one.

Read next

Free for 2 servers, no card. Install the agent in about 30 seconds, then connect Ansible.