From da4a13839ff34702d61023d8a031d46ea4a9e680 Mon Sep 17 00:00:00 2001 From: evebrnd Date: Mon, 15 Jun 2026 19:36:52 +0200 Subject: [PATCH] docs(db): add pg extensions setup section --- docs/src/deployment/configuration.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/src/deployment/configuration.md b/docs/src/deployment/configuration.md index d3b726e5..89c47940 100644 --- a/docs/src/deployment/configuration.md +++ b/docs/src/deployment/configuration.md @@ -121,6 +121,18 @@ spring: validate-on-migrate: true ``` +### PostgreSQL extensions + +IDP-Core depends on PostgreSQL extensions that must be installed in the target database before running schema migrations that rely on them. You have three common options: + +- Provision extensions directly via your Infrastructure as Code (for example Terraform resources) or checking them off in your cloud provider's database management dashboard +- Apply the provided initialization script (`/scripts/init-extensions.sql`) using `psql` from your deployment host +- Add a Flyway migration to your repository. Place a migration such as `V1__install_extensions.sql` in `db/migration` containing the `CREATE EXTENSION` statements. Flyway will execute the SQL file as part of the migration sequence. + +Key note: + +- Installing extensions requires superuser privileges or a role with `CREATE` extension privileges. If your application user lacks those privileges, perform installation as a DBA or during provisioning. + --- ## Application Settings