Skip to main content
User guide

Hosts

What a host object is, what "Enrolled" means, how the managed-host cap is enforced, and where host groups sit in policy.

A Linux machine joined to the domain is a host object in the directory: a Kerberos principal host/<fqdn>, a keytab, and attributes. HBAC, sudo, automount and ID views all target hosts or host groups.

Hosts

List columns

ColumnMeaning
Host nameFQDN; must resolve through IPA DNS or the client's DNS. The name is the key, so renaming is delete and re-add
Descriptionfree text
EnrolledTrue once the host obtained its keytab through ipa-client-install. False is a host pre-created in the directory that has not joined yet

A pre-created (unenrolled) host can already be put in host groups and rules; policy applies the moment the machine joins.

Managed-host cap

The licence tier caps the number of managed hosts (see Licence). A server-side plugin enforces it in host-add: beyond the cap the add is refused, in the UI and in ipa host-add alike. The count is the number of host objects in the directory, unenrolled ones included; IPA servers and replicas themselves are excluded.

At the cap: remove hosts no longer in use (ipa host-disable first to revoke the keytab, then delete) or move up a tier. Current count: ipa host-find --sizelimit=0 | tail -1.

Detail page

Host settings

BlockHoldsNotes
Host settingsprincipal aliases, description, class, locality, location, platform, OS, MAC address, SSH public keysPlatform / OS are reported once by ipa-client-install and not synced afterwards
Enrollmentkeytab state, enrolled byUnprovision revokes the keytab; the host can no longer authenticate with Kerberos but the object stays
Host certificatecertificate issued by the IPA CACertificate issuance is in every tier
Allow to retrieve / create keytabusers / groups / hosts allowed to fetch or regenerate this host's keytabFor automation (Ansible, image provisioning)
Authentication indicatorsrequire tickets for this host to carry a specific method (OTP, RADIUS, PKINIT…)Once set, a password-only ticket does not get in
Trusted for delegationlet this host obtain tickets to other services on the user's behalfOnly for gateway-type hosts that really forward credentials

"Is a member of" lists host groups, netgroups, roles, HBAC and sudo rules; "Is managed by" lists other hosts allowed to manage this one (managedby), used to let host A obtain certificates or keytabs for host B.

Host groups

Host groups

Host groups are the unit of policy. Rules are written against groups; adding a machine changes membership only. Name them by role (webservers, dbservers, bastion), not by rack. For membership by hostname pattern use Automember.

ipaservers is maintained by the installer and holds every IPA server; leave it alone.

Boundaries

  • Renaming a host: delete, re-add, then re-run ipa-client-install on the client.
  • Deleting a host does not remove its A / PTR records from IPA DNS (ipa host-del --updatedns does).
  • The UI cannot see the client's sssd state; whether a login works on the client is in /var/log/sssd/ there.

On this page