Docs

2026.9.0-dev.20260928.3

postgresql

PostgreSQL object-relational database server

postgresql

PostgreSQL object-relational database server

18.6 · aarch64-darwin

Authentication and TLS

Host authentication rules are ordered and typed. Bootstrap, replication, certificate, private-key, and CA values use opaque credential references and never enter generated files.

Initialization and lifecycle

The database cluster is initialized once in durable package state. Desired changes conservatively restart the server because not every PostgreSQL parameter is safely reloadable.

Additional settings

postgresql.settings is reserved for non-secret parameters without a dedicated option. Dedicated or credential-bearing settings cannot be overridden through that map.

postgresql

Option	Type	Description
authentication1 child
bootstrap2 children
clusterName	`string matching [^ ]+`	Cluster name included in process titles and logs.
config	`attribute set of attribute set of any value`	Desired values for the package's declared config artifacts.
credentials	`attribute set of submodule`	Opaque references for the package's declared credentials.
enable	`boolean`	Enable the PostgreSQL database server.
listen2 children
replication9 children
resources4 children
settings	`attribute set of boolean or signed integer or string matching [^ ]*`	Additional non-secret PostgreSQL settings not owned by a dedicated option.
tls5 children
topology	`one of ["standalone","primary","standby"]`	The database server's replication role.