CHANGELOG.md

Community Proxmox Collection Release Notes

Topics

• v2.0.0-beta1
  • Release Summary
  • Minor Changes
  • Bugfixes
  • New Modules
• v1.6.0
  • Release Summary
  • Major Changes
  • Minor Changes
  • Deprecated Features
  • Bugfixes
  • New Modules
• v1.5.0
  • Release Summary
  • Minor Changes
  • Bugfixes
  • New Modules
• v1.4.0
  • Release Summary
  • Minor Changes
  • Bugfixes
  • New Modules
• v1.3.0
  • Release Summary
  • Minor Changes
  • Bugfixes
  • New Modules
• v1.2.0
  • Release Summary
  • Minor Changes
  • New Modules
• v1.1.0
  • Release Summary
  • Minor Changes
  • Bugfixes
  • New Modules
• v1.0.1
  • Release Summary
  • Minor Changes
• v1.0.0
  • Release Summary
  • Minor Changes
  • Breaking Changes / Porting Guide
  • Bugfixes
  • New Modules
• v0.1.0
  • Release Summary

v2.0.0-beta1

Release Summary

This is the first beta major release of the community.proxmox collection. This changelog contains all changes to the modules and plugins in this collection that have been made after the previous release.

Please note that this version of the collection now requires proxmoxer 2.3.0 or higher.

Also note, this release is beta! We are working on a lot of refactoring, so please report any bugs you've found! :-)

Minor Changes

• proxmox - add totp authentification support (ansible-collections#265).
• proxmox - add a new helper create_proxmox_module() which adds generic auth args and constraints, and merges in the module-specific args and options (ansible-collections#289).
• proxmox - update proxmoxer required dependencies to >=2.3 (ansible-collections#265).
• proxmox_kvm - add qemu parameter spice_enhancements (ansible-collections#324).
• proxmox_kvm - add qemu parameter virtiofs (ansible-collections#336).
• proxmox_node - add alias certificate_file_path for cert (ansible-collections#331).
• proxmox_node - add alias node for node_name (ansible-collections#331).
• proxmox_node - add alias private_key_file_path for key (ansible-collections#331).
• proxmox_node - add new parameter certificate to pass raw PEM encoded certificate (ansible-collections#331).
• proxmox_node - add new parameter private_key to pass raw PEM encoded private key (ansible-collections#331).
• proxmox_storage - Add support for RBD (RADOS Block Device) storage (ansible-collections#329).
• proxmox_storage - enhanced error handling and parameters validation (ansible-collections#305).
• proxmox_storage - the parameter state now has a default value of present (ansible-collections#305).
• proxmox_storage - when state=present parameters content and nodes are now not required (ansible-collections#315).

Bugfixes

• proxmox_cluster_firewall - error message for invalid log_ratelimit.rate parameter (ansible-collections#340).
• proxmox_disk - add support for efidisk and tpmstate disk bus types which previously caused module failure with "Unsupported disk bus" error (ansible-collections#319).
• proxmox_pool - support nested pool (ansible-collections#316).
• proxmox_snap - fail the task when a given snapname does not exist instead of exiting (ansible-collections#365).
• proxmox_storage - backend cephfs, dir and zfspool doesn't requires content parameter (ansible-collections#315).
• proxmox_storage - the parameter client_keyring was ignored (ansible-collections#305).
• proxmox_storage - the parameter fs_name was ignored (ansible-collections#305).
• proxmox_storage - the parameter state was optional and without default value (ansible-collections#305).

New Modules

• community.proxmox.proxmox_cluster_firewall - Cluster-level firewall options management for Proxmox VE cluster.
• community.proxmox.proxmox_cluster_ha_rules_info - Retrieve Proxmox VE HA rules.
• community.proxmox.proxmox_domain - Manage authentication realms.
• community.proxmox.proxmox_domain_sync - Sync realms.

v1.6.0

Release Summary

This is the minor release of the community.proxmox collection. This changelog contains all changes to the modules and plugins in this collection that have been made after the previous release.

Major Changes

• proxmox - Add ca_path option to specify a ca-certificate for tls validation (ansible-collections#256).

Minor Changes

• inventory plugin - add want_post_filtering_facts to delay fact gathering until filtering has completed (ansible-collections#261).
• proxmox - Add api_timeout option for all modules (ansible-collections#253).
• proxmox - set state as not required and set default value present (ansible-collections#292).
• proxmox_role - add role's privs on the return data (ansible-collections#283).
• proxmox_storage - Add support for ZFS thin-provisioning (ansible-collections#265).
• proxmox_storage - Add the option namespace for PBS storage (ansible-collections#282)
• proxmox_storage - refactor the validation of storage options (ansible-collections#266).
• proxmox_storage_contents_info - Add support for content type import (ansible-collections#260).
• proxmox_zone, proxmox_vnet, proxmox_subnet - make sdn modules compatible with pve8 (ansible-collections#254).

Deprecated Features

• proxmox - Certificate verification default changes from false to true with version 2.0.0 (ansible-collections#256).

Bugfixes

• proxmox_cluster - make cluster join idempotent (ansible-collections#244).
• proxmox_disk - make none iso disk idempotent (ansible-collections#288).
• proxmox_firewall - Enable ipsets on vm level and fix bugs regarding the cidr notation the proxmox api expects (ansible-collections#248).
• proxmox_role - when privs is omitted, keep existing role privileges unchanged instead of treating it as no privileges (ansible-collections#284).

New Modules

• community.proxmox.proxmox_role - Role management for Proxmox VE cluster.

v1.5.0

Release Summary

This is the minor release of the community.proxmox collection. This changelog contains all changes to the modules and plugins in this collection that have been made after the previous release.

Minor Changes

• inventory plugin, plugin_utils - replace deprecated ansible.module_utils.common._collections_compat imports with collections.abc from the Python standard library (ansible-collections#241).
• proxmox - change disk size units to GiB (ansible-collections#236).
• proxmox_disk - change disk size units to GiB (ansible-collections#236).
• proxmox_kvm - add option to migrate local disks as well (ansible-collections#240).
• proxmox_kvm - change disk size units to GiB (ansible-collections#236).
• proxmox_node_info - add information on node network interfaces to node information output (ansible-collections#220).
• proxmox_node_info - add information on node's PVE version (ansible-collections#225).
• proxmox_snap_info - Adds a new module to list snapshots or a specific snapshot for VM or container (ansible-collections#229).
• proxmox_storage - add feature of subdirectory in CIFS share. (ansible-collections#214).
• proxmox_storage - fix passing nfs_options to API payload (ansible-collections#203, ansible-collections#221).
• proxmox_storage - fixed CIFS authentication by sending username and password parameters to proxmoxer (ansible-collections#214).

Bugfixes

• proxmox all - add missing timeout parameter to proxmoxer object creation (ansible-collections#218).
• proxmox_ipam_info - fix bug where selecting by vmid did not work (ansible-collections#211).
• proxmox_zone - fix validation logic for VXLAN zones to accept either fabric or peers parameter. Previously, only fabric was accepted, but Proxmox VE also supports creating VXLAN zones with a peer address list (ansible-collections#216).
• remove wrong api endpoints and error messages from proxmod_node certificate management(ansible-collections#232).

New Modules

• community.proxmox.proxmox_ceph_mds - Add or delete Ceph Mds.
• community.proxmox.proxmox_ceph_mgr - Add or delete Ceph Manager.
• community.proxmox.proxmox_ceph_mon - Add or delete Ceph Monitor.
• community.proxmox.proxmox_sendkey - Send key presses to a Proxmox VM console.

v1.4.0

Release Summary

This is the minor release of the community.proxmox collection. This changelog contains all changes to the modules and plugins in this collection that have been made after the previous release.

Minor Changes

• proxmox - Add delete parameter to delete settings (ansible-collections#195).
• proxmox_cluster - Add master_api_password for authentication against master node (ansible-collections#140).
• proxmox_cluster - added link0 and link1 to join command (ansible-collections#168, ansible-collections#172).
• proxmox_kvm - update description of machine parameter in proxmox_kvm.py (ansible-collections#186)
• proxmox_storage - added dir and zfspool storage types (ansible-collections#184)
• proxmox_tasks_info - add source option to specify tasks to consider (ansible-collections#179)
• proxmox_template - Add 'import' to allowed content types of proxmox_template, so disk images and can be used as disk images on VM creation (ansible-collections#162).

Bugfixes

• proxmox inventory plugin and proxmox module utils - avoid Python 2 compatibility imports (ansible-collections#175).
• proxmox_kvm - remove limited choice for vga option in proxmox_kvm (ansible-collections#185)
• proxmox_kvm, proxmox_template - remove ansible.module_utils.six dependency (ansible-collections#201).
• proxmox_storage - fixed adding PBS-type storage by ensuring its parameters (server, datastore, etc.) are correctly sent to the Proxmox API (ansible-collections#171).
• proxmox_user - added a third case when testing for not-yet-existant user (ansible-collections#163)
• proxmox_vm_info - do not throw exception when iterating through machines and optional api results are missing (ansible-collections#191)

New Modules

• community.proxmox.proxmox_cluster_ha_rules - Management of HA rules.
• community.proxmox.proxmox_firewall - Manage firewall rules in Proxmox.
• community.proxmox.proxmox_firewall_info - Manage firewall rules in Proxmox.
• community.proxmox.proxmox_ipam_info - Retrieve information about IPAMs.
• community.proxmox.proxmox_subnet - Create/Update/Delete subnets from SDN.
• community.proxmox.proxmox_vnet - Manage virtual networks in Proxmox SDN.
• community.proxmox.proxmox_vnet_info - Retrieve information about one or more Proxmox VE SDN vnets.
• community.proxmox.proxmox_zone - Manage Proxmox zone configurations.
• community.proxmox.proxmox_zone_info - Get Proxmox zone info.

v1.3.0

Release Summary

This is the minor release of the community.proxmox collection. This changelog contains all changes to the modules and plugins in this collection that have been made after the previous release.

Minor Changes

• proxmox* modules - added fallback environment variables for api_token, api_secret, and validate_certs (ansible-collections#63, ansible-collections#136).
• proxmox_cluster_ha_groups - fix idempotency in proxmox_cluster_ha_groups module (ansible-collections#138, ansible-collections#139).
• proxmox_cluster_ha_resources - Fix idempotency proxmox_cluster_ha_resources (ansible-collections#135).
• proxmox_kvm - Add missing 'storage' parameter to create_vm()-call.
• proxmox_kvm - add new purge parameter to proxmox_kvm module (ansible-collections#60, ansible-collections#148).

Bugfixes

• proxmox_pct_remote connection plugin - avoid deprecated ansible-core paramiko import helper, import paramiko directly instead (ansible-collections#146, ansible-collections#151).

New Modules

• community.proxmox.proxmox_storage - Manage storage in PVE clusters and nodes.

v1.2.0

Release Summary

This is the minor release of the community.proxmox collection. This changelog contains all changes to the modules and plugins in this collection that have been made after the previous release.

Minor Changes

• proxmox inventory plugin - always provide basic information regardless of want_facts (ansible-collections#124).
• proxmox_cluster - cluster creation has been made idempotent (ansible-collections#125).
• proxmox_pct_remote - allow forward agent with paramiko (ansible-collections#130).

New Modules

• community.proxmox.proxmox_group - Group management for Proxmox VE cluster.
• community.proxmox.proxmox_node - Manage Proxmox VE nodes.
• community.proxmox.proxmox_user - User management for Proxmox VE cluster.

v1.1.0

Release Summary

This is the minor release of the community.proxmox collection. This changelog contains all changes to the modules and plugins in this collection that have been made after the previous release.

Minor Changes

• proxmox - allow force deletion of LXC containers (ansible-collections#105).
• proxmox - validate the cluster name length (ansible-collections#119).

Bugfixes

• proxmox inventory plugin - avoid using deprecated option when templating options (ansible-collections#108).

New Modules

• community.proxmox.proxmox_access_acl - Manages ACLs on the Proxmox PVE cluster.
• community.proxmox.proxmox_cluster_ha_groups - Management of HA groups in Proxmox VE Cluster.
• community.proxmox.proxmox_cluster_ha_resources - Management of HA groups in Proxmox VE Cluster.

v1.0.1

Release Summary

This is a minor bugfix release for the community.proxmox collections. This changelog contains all changes to the modules and plugins in this collection that have been made after the previous release.

Minor Changes

• proxmox module utils - fix handling warnings in LXC tasks (ansible-collections#104).

v1.0.0

Release Summary

This is the first stable release of the community.proxmox collection since moving from community.general, released on 2025-06-08.

Minor Changes

• proxmox - add support for creating and updating containers in the same task (ansible-collections#92).
• proxmox module util - do not hang on tasks that throw warnings (ansible-collections#96, ansible-collections#100).
• proxmox_kvm - add rng0 option to specify an RNG device (ansible-collections#18).
• proxmox_kvm - remove redundant check for duplicate names as this is allowed by PVE API (ansible-collections#97, ansible-collections#99).
• proxmox_snap - correctly handle proxmox_snap timeout parameter (ansible-collections#73, ansible-collections#95, ansible-collections#101).

Breaking Changes / Porting Guide

• proxmox - update and force are now mutually exclusive (ansible-collections#92).
• proxmox - the default of update changed from false to true (ansible-collections#92).

Bugfixes

• proxmox - fix crash in module when the used on an existing LXC container with state=present and force=true (ansible-collections#91).

New Modules

• community.proxmox.proxmox_backup_schedule - Schedule VM backups and removing them.
• community.proxmox.proxmox_cluster - Create and join Proxmox VE clusters.
• community.proxmox.proxmox_cluster_join_info - Retrieve the join information of the Proxmox VE cluster.

v0.1.0

Release Summary

This is the first community.proxmox release. It contains mainly the state of the Proxmox content in community.general 10.6.0. The minimum required ansible-core version for community.proxmox is ansible-core 2.17, which implies Python 3.7+. The minimum required proxmoxer version is 2.0.0.