[Zaimwa9]

Thanks for submitting a PR! Please check the boxes below:

• I have read the Contributing Guide.
• I have added information to docs/ if required so people know about the feature.
• I have filled in the "Changes" section below.
• I have filled in the "How did you test this code" section below.

Changes

Documents PostgreSQL warehouses (#8857, #8863, #8864, #8872).

• New Connect PostgreSQL (bring your own) and Self-Hosting and Open Source (deployment options, SDK events URL, limits) pages.
• Connect a Warehouse covers the self-hosted Flagsmith database next to the Cloud Flagsmith warehouse.
• Setup copy now asks for a superuser or a role with CREATEROLE and CREATE on the database, and the setup SQL password placeholder is YOUR_PASSWORD.
• A parity test keeps the docs' setup SQL in line with the dashboard's.

How did you test this code?

Prettier, and the setup SQL unit and docs parity tests.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
docs	Ready	Preview	Nov 6, 2026 9:55am UTC

2 Skipped Deployments

Project	Deployment	Actions	Updated
flagsmith-frontend-preview	Ignored	Preview	Nov 6, 2026 9:55am UTC
flagsmith-frontend-staging	Ignored	Preview	Nov 6, 2026 9:55am UTC

[coderabbitai]

No actionable comments were generated in the recent review.

Walkthrough

The changes add self-hosting guidance for experimentation, including event routing and rejection limits. They document PostgreSQL as an experiment-event warehouse and provide setup, permissions, connection, and troubleshooting instructions. Existing warehouse guidance now covers PostgreSQL and limits first-event verification instructions to Flagsmith Cloud where specified. ClickHouse and PostgreSQL onboarding SQL use the <YOUR_PASSWORD> placeholder. A test checks that the documented PostgreSQL SQL matches the generated onboarding SQL.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Merge Risk: Low · up to 49dda

PostgreSQL setup can fail with restricted database permissions or an existing schema. The SQL parity test can also miss line-sensitive changes; these bounded issues warrant follow-up.

- [ ] Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

• X
• Mastodon
• Reddit
• LinkedIn

Recent review info

Run configuration

• Source mode: Auto
• Repository: Unavailable
• Branch: Unavailable
• File: No configuration file from this repository applied
• Commit: Unavailable
• Layers: Organization UI
• Review profile: ASSERTIVE
• Plan: Advanced
• Run ID: bf1c7b83-9f32-486e-91bd-1b15a040a206

Commits

Reviewing files that changed from the base of the PR and between 6cc79f8 and 49ddaed.

Files selected for processing: 3

• docs/docs/experimentation/connect-a-warehouse.md
• docs/docs/experimentation/connect-postgresql.md
• docs/docs/experimentation/self-hosting.md

Included review availability: This review used your included allowance. Your plan provides up to 8 included reviews per hour; 7 remain after this review.

[github-actions]

Docker builds report

Image	Build Status	Security report
ghcr.io/flagsmith/flagsmith-e2e:pr-8873	Finished ✅	Skipped
ghcr.io/flagsmith/flagsmith-api-test:pr-8873	Finished ✅	Skipped
ghcr.io/flagsmith/flagsmith-api:pr-8873	Finished ✅	Results ✅
ghcr.io/flagsmith/flagsmith:pr-8873	Finished ✅	Results ✅
ghcr.io/flagsmith/flagsmith-private-cloud:pr-8873	Finished ✅	Results ✅
ghcr.io/flagsmith/flagsmith-frontend:pr-8873	Finished ✅	Results ✅

[github-actions]

✅ private-cloud · depot-ubuntu-latest-arm-16 — run #22905 (attempt 1)

Playwright Test Results (private-cloud - depot-ubuntu-latest-arm-16)

 3 passed

Details

 3 tests across 3 suites
 46.2 seconds
 49ddaed
 🔄 Run: #22905 (attempt 1)

🗂️ Previous results

✅ private-cloud · depot-ubuntu-latest-16 — run #22905 (attempt 1)

Playwright Test Results (private-cloud - depot-ubuntu-latest-16)

 3 passed

Details

 3 tests across 3 suites
 51 seconds
 49ddaed
 🔄 Run: #22905 (attempt 1)

✅ oss · depot-ubuntu-latest-arm-16 — run #22905 (attempt 1)

Playwright Test Results (oss - depot-ubuntu-latest-arm-16)

 1 passed

Details

 1 test across 1 suite
 35.4 seconds
 49ddaed
 🔄 Run: #22905 (attempt 1)

✅ oss · depot-ubuntu-latest-16 — run #22905 (attempt 1)

Playwright Test Results (oss - depot-ubuntu-latest-16)

 1 passed

Details

 1 test across 1 suite
 30.6 seconds
 49ddaed
 🔄 Run: #22905 (attempt 1)

✅ private-cloud · depot-ubuntu-latest-arm-16 — run #22891 (attempt 1)

Playwright Test Results (private-cloud - depot-ubuntu-latest-arm-16)

 2 passed

Details

 2 tests across 2 suites
 45.7 seconds
 6cc79f8
 🔄 Run: #22891 (attempt 1)

✅ private-cloud · depot-ubuntu-latest-16 — run #22891 (attempt 1)

Playwright Test Results (private-cloud - depot-ubuntu-latest-16)

 3 passed

Details

 3 tests across 3 suites
 34 seconds
 6cc79f8
 🔄 Run: #22891 (attempt 1)

✅ oss · depot-ubuntu-latest-arm-16 — run #22891 (attempt 1)

Playwright Test Results (oss - depot-ubuntu-latest-arm-16)

 2 passed

Details

 2 tests across 2 suites
 36.6 seconds
 6cc79f8
 🔄 Run: #22891 (attempt 1)

✅ oss · depot-ubuntu-latest-16 — run #22891 (attempt 1)

Playwright Test Results (oss - depot-ubuntu-latest-16)

 2 passed

Details

 2 tests across 2 suites
 32 seconds
 6cc79f8
 🔄 Run: #22891 (attempt 1)

[github-actions]

Visual Regression

24 screenshots compared. See report for details.
View full report

[coderabbitai]

Actionable comments posted: 3

Nitpick comments: 1

frontend/web/components/pages/environment-settings/tabs/warehouse-tab/__tests__/postgresSetupSqlDocs.test.ts: 1

5-5: Trivial · Functional Correctness · Quick win

Normalise each line separately in the docs parity test.

normalise replaces every line break with a space. In the docs fence, a -- comment can then run into the next statement. If a future edit moves CREATE USER onto the comment line, the normalised text still matches the dashboard SQL, so the test passes. PostgreSQL does not run the joined CREATE USER, and the following GRANT statements fail because the role does not exist. The current guide is correct, so this affects only future edits to the docs.

Normalise each line separately to keep the line boundaries:

Suggested fix

-const normalise = (sql: string) => sql.replace(/\s+/g, ' ').trim()
+const normalise = (sql: string) =>
+  sql
+    .split('\n')
+    .map((line) => line.replace(/\s+/g, ' ').trim())
+    .filter(Boolean)
+    .join('\n')

Review info

Run configuration

• Source mode: Auto
• Repository: Unavailable
• Branch: Unavailable
• File: No configuration file from this repository applied
• Commit: Unavailable
• Layers: Organization UI
• Review profile: ASSERTIVE
• Plan: Advanced
• Run ID: e8cffcbc-124d-455d-98d0-45909dde738b

Commits

Reviewing files that changed from the base of the PR and between af5c88f and 6cc79f8.

Files ignored due to path filters: 4

• docs/static/img/experimentation/warehouse-flagsmith-database-connected.png is excluded by !**/*.png
• docs/static/img/experimentation/warehouse-flagsmith-database.png is excluded by !**/*.png
• docs/static/img/experimentation/warehouse-postgres-connected.png is excluded by !**/*.png
• docs/static/img/experimentation/warehouse-postgres-form.png is excluded by !**/*.png

Files selected for processing: 13

• docs/docs/deployment-self-hosting/core-configuration/environment-variables.md
• docs/docs/deployment-self-hosting/hosting-guides/kubernetes-openshift.md
• docs/docs/experimentation/connect-a-warehouse.md
• docs/docs/experimentation/connect-databricks.md
• docs/docs/experimentation/connect-postgresql.md
• docs/docs/experimentation/run-an-experiment.mdx
• docs/docs/experimentation/self-hosting.md
• frontend/web/components/pages/environment-settings/tabs/warehouse-tab/WarehouseSetup.tsx
• frontend/web/components/pages/environment-settings/tabs/warehouse-tab/__tests__/clickhouseSetupSql.test.ts
• frontend/web/components/pages/environment-settings/tabs/warehouse-tab/__tests__/postgresSetupSql.test.ts
• frontend/web/components/pages/environment-settings/tabs/warehouse-tab/__tests__/postgresSetupSqlDocs.test.ts
• frontend/web/components/pages/environment-settings/tabs/warehouse-tab/clickhouseSetupSql.ts
• frontend/web/components/pages/environment-settings/tabs/warehouse-tab/postgresSetupSql.ts

Included review availability: This review used your included allowance. Your plan provides up to 8 included reviews per hour; 7 remain after this review.