Requirements
Ansible Version¶
Minimum Ansible version: 2.14 or higher
Check your version:
Python Requirements¶
Python version: 3.8 or higher
The collection uses Python for: - Custom modules - Filters and plugins - Testing framework (Molecule)
Platform Support¶
The collection is tested on:
- Rocky Linux 9 (RHEL-compatible)
- Debian 12 (Bookworm)
- Ubuntu 24.04 (Noble)
Other distributions may work but are not officially tested.
Container Runtime¶
For containerized deployments:
- Podman (primary, recommended)
- Docker (community support only)
Important: The collection uses Podman exclusively. Systemd quadlets are used for container management.
Storage Backends¶
Supported storage options:
- Local storage (default)
- NFS mounts (for shared storage)
- S3-compatible object storage (for InfluxDB and Loki)
Network Requirements¶
Server Components (InfluxDB, Loki)¶
- InfluxDB: Port 8086 (HTTP API)
- Loki: Port 3100 (HTTP API)
- WireGuard: Port 51820 (UDP) for remote collectors
Client Components (Telegraf, Alloy)¶
- Outbound HTTPS to metrics/log servers
- WireGuard client for secure remote connections
Privilege Requirements¶
Most roles require: - sudo/become access for installing packages - systemd service management - podman socket access for container deployments
Disk Space¶
Recommended disk space:
- Server deployments: 50GB+ for metrics/logs (depends on retention)
- Client deployments: 500MB for agent binaries and configs
- Testing: 10GB for molecule scenarios
Memory Requirements¶
Minimum memory:
- InfluxDB server: 2GB RAM
- Loki server: 1GB RAM
- Telegraf client: 128MB RAM
- Alloy client: 256MB RAM