Configuration parameter

krb_server_keyfile — PostgreSQL configuration parameter

Category Connections and Authentication Default FILE:/usr/local/pgsql/etc/krb5 Change scope Sighup

Sets the location of the server’s Kerberos key file.

At a glance

Property Value
Parameter krb_server_keyfile
Category Connections and Authentication
Default FILE:/usr/local/pgsql/etc/krb5.keytab
Value type string
Change scope Reload (postgresql.conf, SIGHUP)
Available in PostgreSQL 12, 13, 14, 15, 16, 17, 18, 19 (added in 12)

What it does

Sets the location of the server’s Kerberos key file. The default is FILE:/usr/local/pgsql/etc/krb5.keytab (where the directory part is whatever was specified as sysconfdir at build time; use pg_config –sysconfdir to determine that). If this parameter is set to an empty string, it is ignored and a system-dependent default is used. This parameter can only be set in the postgresql.conf file or on the server command line. See gssapi_auth for more information.

(Description quoted from the official PostgreSQL documentation.)

How to apply a change

Set it in postgresql.conf (or with ALTER SYSTEM) and reload with SELECT pg_reload_conf(); or pg_ctl reload — no restart needed.

Inspect the current value and source with SHOW krb_server_keyfile; or SELECT name, setting, unit, context, source FROM pg_settings WHERE name = 'krb_server_keyfile';.

Tuning guidance

This is a connectivity or security setting, not a performance knob. Choose the value from your security and network requirements (TLS files, ciphers, keepalives, authentication behaviour) rather than for throughput, and verify it against your organization’s policy. Test changes in staging, because a wrong value here can lock clients out.

Reference

PostgreSQL documentation — krb_server_keyfile.

Keep going

Related & next steps

Concepts on this page

Was this helpful?

← All configuration parameters