Skip to main content
User guide

Configuration

Global defaults, including search limits, default shell, home, group and 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.

This page covers the Configuration page under IPA Server. It holds 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/homeA new user's home is the base plus the login
Default shell/bin/shShell for new users. Most sites change it to /bin/bash
Maximum username length32None
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. Changed 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. On, 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,descriptionAttributes the list search box matches
Default group objectclassestop, groupofnames, nestedgroup, ipausergroup, ipaobjectLDAP object classes new groups carry

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

TopicNotes
Client cacheChanges are written to the directory at once, but client sssd caches keep the old user attributes. Settings such as Domain resolution order need sss_cache -E
Factory resetNone on this page. Note the old value before changing one
Policy locationPassword policy and ticket policy are not here; each has its own page

On this page