PostgreSQL setup

GitLab 19 requires an externally managed PostgreSQL 17 database. The Big Bang GitLab package does not deploy PostgreSQL or a CloudNativePG Cluster.

Configure the database with global.psql as described in operational-production-settings.md and the upstream external database guide. The database must provide all extensions required by GitLab.

If CloudNativePG is selected as the external database platform, install and validate an operator such as the Big Bang maintained CloudNativePG operator before creating a Cluster. The operator and database lifecycle, sizing, high availability, backup, restore, and disaster recovery remain the consumer’s responsibility.

Users of the PostgreSQL chart formerly bundled with GitLab must migrate while still on GitLab 18.11. Follow the GitLab 19 upgrade guide before installing chart 10.