Deploy PumaGate in three steps: configure your pumagate.com account, set up a Gateway, and deploy Agents on target hosts. The diagram below shows the deployment sequence and component relationships.

Choose Your Platform

Linux

Native installation on Linux servers with systemd service management.

Recommended

Ubuntu, Debian, RHEL, CentOS, Rocky

Container

Docker and Docker Compose deployments with host kernel access.

GA

Docker, Docker Compose

Infrastructure Automation

Deploy PumaGate agents at scale using your favourite infrastructure automation tools. Each module is available in its own GitHub repository.

Repositories: github.com/pumagate/pumagate-ansible github.com/pumagate/pumagate-puppet github.com/pumagate/pumagate-terraform

Ansible

Playbooks and roles for automated deployment across your fleet.

GA

pumagate/pumagate-ansible

Puppet

Puppet module with Hiera integration for enterprise deployments.

GA

pumagate/pumagate-puppet

Terraform

Cloud-init scripts and modules for AWS, GCP, and Azure.

GA

pumagate/pumagate-terraform

Quick Start

For the fastest agent installation on Linux, run:

curl -sSL https://pumagate.com/install/YOUR_ORG_UUID | sudo bash

Allow outbound HTTPS (443) to your PumaGate appliance and updates.pumagate.com for verified agent downloads and updates.

For Docker deployments:

docker run -d --name pumagate-agent --privileged --pid=host --network=host \
  -v /sys:/sys:ro -v /proc:/proc:ro \
  -e AGENT_API_URL=https://pumagate.com \
  -e AGENT_TENANT_ID=00000000-0000-0000-0000-000000000000 \
  pumagate/agent:latest

Platform Support

Platform	Architecture	Minimum Kernel	Status
Linux (Standalone)	amd64, arm64	4.9+	GA
Docker	amd64, arm64	4.9+ (host)	GA

Downloads

Agent binaries and installation scripts are available from the PumaGate update repository:

Linux (amd64)
pumagate-agent-linux-amd64

Linux (arm64)
pumagate-agent-linux-arm64

Docker Image
pumagate/agent:latest

Browse All Downloads

Installation Guide