Skip to main content
User guide

Configuration

Global defaults: search limits, default shell / home / group / e-mail domain for new users, default authentication type, user and group object classes, the SELinux user list, CA renewal and PKINIT masters. Changes affect objects created afterwards.

The Configuration page is the directory's global settings (ipa config-show). Most fields are defaults for new objects: changing the default shell leaves existing users alone. All IPA servers share the one copy.

Configuration

Search options

FieldDefaultMeaning
Search size limit100maximum rows a list page or ipa *-find returns; beyond it the list reports a truncated result. ipa *-find --sizelimit=0 is unlimited
Search time limit2 smaximum time for one query

Past ten thousand users raise the size limit to 500 or more, or list pages cannot find the later ones; raise the time limit to 5 s alongside.

User options

FieldDefaultMeaning
User search fieldsuid,givenname,sn,telephonenumber,ou,titleattributes the list search box matches
Default e-mail domainthe domaina new user without an e-mail gets uid@domain
Default users groupipausersgroup every new user joins
Home directory base/homenew user's home = base + login
Default shell/bin/shshell for new users; most sites change it to /bin/bash
Maximum username length32
Password expiration notification4 dayshow many days before expiry clients warn at login
Default user authentication typepasswordused when a user has no authentication type ticked. Setting it to two-factor enforces OTP for everyone
Default user objectclassestop, person, organizationalperson, inetorgperson, inetuser, posixaccount, krbprincipalaux, krbticketpolicyaux, ipaobject, ipasshuserLDAP object classes new users carry; touch only when adding custom schema
Domain resolution orderemptywhich domains to try, in order, for a bare username: linux.ipa.test:ad.ipa.test. With it set, AD users can log in without the @ad.ipa.test suffix
Migration modeoffusers brought in with ipa migrate-ds have no Kerberos keys; leave this on so they are generated at first login, off once migration is done
Default subordinate IDoffallocate subordinate IDs to new users automatically

Group options

FieldDefaultMeaning
Group search fieldscn,description
Default group objectclassestop, groupofnames, nestedgroup, ipausergroup, ipaobject

SELinux options

FieldMeaning
SELinux user map orderthe $-separated list of SELinux users available to SELinux user maps; its order breaks ties when several maps match
Default SELinux uservalue when no map matches

Service options

FieldMeaning
Default PAC typewhether service tickets carry MS-PAC, PAD or nfs:NONE by default. Keep MS-PAC with a trust

Server options

FieldMeaning
IPA CA renewal masterthe one server that renews the CA's own certificates. Move it with ipa config-mod --ca-renewal-master-server= before decommissioning that server
IPA masters capable of PKINITread-only list of servers whose KDC can do certificate authentication

Boundaries

  • Changes are written to the directory at once, but client sssd caches keep the old user attributes; things like domain resolution order need sss_cache -E.
  • There is no factory reset on this page; note the old value before changing one.
  • Password policy and ticket policy are not here; each has its own page.

On this page