A collection for managing Proxmox VE and Backup Server hosts. Contains roles for managing the PVE/PBS ecosystem, as well as modules to manage PBS configuration. With this collection, you can:

• Perform basic setup of your PVE servers (configuring PVE repositories, root user access, CPU governor)
• Configure a PBS server (including smart monitoring, etc.)
• Install and configure the Proxmox Backup Client on supported systems
• Manage Proxmox Backup Server users, repositories and permissions

📘 Documentation

• For role documentation, see their README.mds or the online docs here
• For modules documentation, see the online docs here

• lxc_container: Create and bootstrap LXC containers on Proxmox for Ansible access
• lxc_container_to_ostemplate: Generate ostemplate (LXC container) images from existing LXC containers
• pve: Perform basic system-level setup tasks on PVE nodes
• pbs: Perform basic system-level setup tasks on Proxmox Backup Server hosts
• pbs_client: Install and configure the Proxmox Backup Client

• proxmox_ha: Manage High Availability settings for a VM/Container

• pbs_acl`
• pbs_datastore`
• pbs_directory`
• pbs_token`
• pbs_user`

• A recent release of Ansible. This collection officially supports the 2 most recent Ansible releases. Older versions might still work, but are not supported
• Python 3.6 or newer on the target host
• For module usage, the proxmoxer and requests python modules are required on the controller host

Individual roles or modules may have additional dependencies, please check their respective documentation.

Via ansible-galaxy (recommended):

ansible-galaxy collection install maxhoesel.proxmox

Alternatively, you can download a collection archive from a previous release.

You can also clone this repository directly if you want a slightly more up-to-date (and potentially buggy) version.

ansible-galaxy collection install git+https://github.com/maxhoesel-ansible/ansible-collection-proxmox

Created & Maintained by Max Hösel (@maxhoesel) and Contributors

Licensed under the GPL 3.0 or later