Roles and playbooks to deploy FreeIPA servers, replicas and clients
Repositories
AppStream
Description
Ansible roles to install and uninstall FreeIPA servers, replicas and clients,
roles for backups and SmartCard configuration, modules for management and also
playbooks for all roles and modules.
Note: The Ansible playbooks and roles require a configured Ansible environment
where the Ansible nodes are reachable and are properly set up to have an IP
address and a working package manager.
Features
- Server, replica and client deployment
- Cluster deployments: Server, replicas and clients in one playbook
- One-time-password (OTP) support for client installation
- Repair mode for clients
- Backup and restore, also to and from controller
- Smartcard setup for servers and clients
- Inventory plugin freeipa
- Modules for automembership rule management
- Modules for automount key management
- Modules for automount location management
- Modules for automount map management
- Modules for certificate management
- Modules for config management
- Modules for delegation management
- Modules for dns config management
- Modules for dns forwarder management
- Modules for dns record management
- Modules for dns zone management
- Modules for group management
- Modules for hbacrule management
- Modules for hbacsvc management
- Modules for hbacsvcgroup management
- Modules for host management
- Modules for hostgroup management
- Modules for idoverridegroup management
- Modules for idoverrideuser management
- Modules for idp management
- Modules for idrange management
- Modules for idview management
- Modules for location management
- Modules for netgroup management
- Modules for permission management
- Modules for privilege management
- Modules for pwpolicy management
- Modules for role management
- Modules for self service management
- Modules for server management
- Modules for service management
- Modules for service delegation rule management
- Modules for service delegation target management
- Modules for sudocmd management
- Modules for sudocmdgroup management
- Modules for sudorule management
- Modules for topology management
- Modules for trust management
- Modules for user management
- Modules for vault management
Supported FreeIPA Versions
FreeIPA versions 4.6 and up are supported by all roles.
The client role supports versions 4.4 and up, the server role is working with
versions 4.5 and up, the replica role is currently only working with versions
4.6 and up.
Supported Distributions
- RHEL/CentOS 7.4+
- Fedora 26+
- Ubuntu
- Debian 10+ (ipaclient only, no server or replica!)
Requirements
Controller
- Ansible version: 2.14+
Node
- Supported FreeIPA version (see above)
- Supported distribution (needed for package installation only, see above)
Limitations
External signed CA is now supported. But the currently needed two step process
is an issue for the processing in a simple playbook.
Work is planned to have a new method to handle CSR for external signed CAs in
a separate step before starting the server installation.
* Fri Aug 01 2025 Thomas Woerner <twoerner@redhat.com> - 1.15.1-1
- Update to version 1.15.1
Resolves: RHEL-104652
- ipaclient: client_dns has new statestore arg with IPA change e6445b8
Resolves: RHEL-106558
* Fri Jul 25 2025 Thomas Woerner <twoerner@redhat.com> - 1.15.0-1
- Update to version 1.15.0
Resolves: RHEL-104652
- ipaclient: Fix AttributeError by defaulting dns_over_tls to False
Resolves: RHEL-92844
- Provide compatibility for AAH naming
Resolves: RHEL-94769
- Ensure ipaidrange required parameters are correct on recent versions of IPA
Resolves: RHEL-79820
- Add support for DNS-over-TLS for ipaclient, ipareplica and ipaserver roles
Resolves: RHEL-78636
* Tue May 06 2025 Thomas Woerner <twoerner@redhat.com> - 1.14.6-1
- Update to version 1.14.6
- Fix CA certificates iteration in ipaclient role
Resolves: RHEL-88206
* Tue Feb 11 2025 Thomas Woerner <twoerner@redhat.com> - 1.14.5-1
- Update to version 1.14.5
Resolves: RHEL-67566
- ipa* deployment roles: Hotfix for dns_over_tls (Freeipa#7343)
Resolves: RHEL-78230
* Tue Feb 04 2025 Thomas Woerner <twoerner@redhat.com> - 1.14.4-1
- Update to version 1.14.4
Resolves: RHEL-67566
- Fix management of AD objects for ipagroup
Resolves: RHEL-25009
* Mon Feb 03 2025 Thomas Woerner <twoerner@redhat.com> - 1.14.3-1
- Update to version 1.14.3
Resolves: RHEL-67566
- Fix management of AD objects for ipagroup
Resolves: RHEL-25009
* Fri Dec 13 2024 Thomas Woerner <twoerner@redhat.com> - 1.14.2-1
- Update to version 1.14.2
https://github.com/freeipa/ansible-freeipa/releases/tag/v1.14.2
Resolves: RHEL-67566
- ipareplica: Pass ipareplica_ip_addresses to ipaclient
Resolves: RHEL-40227
- ipagroup: Correctly handle externalmember in member actions
Resolves: RHEL-25009
- ipasudorule: Evaluate all members related to hosts and users
Resolves: RHEL-68439
- ipacert: Correctly handle removFromCRL revocation
Resolves: RHEL-70016
- Collection: No more role module duplication
Resolves: RHEL-71123
* Wed Nov 27 2024 Thomas Woerner <twoerner@redhat.com> - 1.14.1-1
- Update to version 1.14.1
https://github.com/freeipa/ansible-freeipa/releases/tag/v1.14.1
Resolves: RHEL-67566
- Fix requirements for ansible-core
Resolves: RHEL-69146
* Fri Nov 22 2024 Thomas Woerner <twoerner@redhat.com> - 1.14.0-1
- Update to version 1.14.0
https://github.com/freeipa/ansible-freeipa/releases/tag/v1.14.0
Resolves: RHEL-67566
- Multi sudorule management with the ipasudorule module
Resolves: RHEL-61431
* Mon Jul 01 2024 Thomas Woerner <twoerner@redhat.com> - 1.13.2-1
- Update to version 1.13.2
https://github.com/freeipa/ansible-freeipa/releases/tag/v1.13.2
Resolves: RHEL-35565
- Convert input certificates
Resolves: RHEL-44614
- Fix rolesdeployment with IPA 4.12
Resolves: RHEL-40869
