Database


Database

Only PostgreSQL is supported

Mind the version requirements

Multiple connections since v16

GitLab is preparing a separate database for CI/CD features

Two connections to single database since 16.0 (May 2023)

Disable second connection to single database

Separate database required in 18.0 (May 2025)

Migration to second database is not ready for production yet


Important database tables

Table Contents
users Users
namespaces Groups
projects Projects
ci_builds CI Jobs
ci_pipelines CI Pipelines
ci_stages CI Stages
ci_runners CI Runners

Enter database

docker compose --project-name gitlab exec gitlab gitlab-psql