From 0b07b7b17355775efafc8854b379c7adfee79fe6 Mon Sep 17 00:00:00 2001
From: Tiago Farto <tiago@formbricks.com>
Date: Thu, 19 Feb 2026 10:33:38 +0000
Subject: [PATCH] chore: assorted fixes

---
 .env.example              | 7 ++++---
 README.md                 | 2 +-
 docker-compose.dev.yml    | 2 +-
 docker/docker-compose.yml | 8 +++++++-
 4 files changed, 13 insertions(+), 6 deletions(-)

diff --git a/.env.example b/.env.example
index 36894e2258..b441a68a51 100644
--- a/.env.example
+++ b/.env.example
@@ -41,9 +41,10 @@ DATABASE_URL='postgresql://postgres:postgres@localhost:5432/formbricks?schema=pu
 #################
 #  HUB (DEV)    #
 #################
-# Optional. The dev stack (pnpm db:up / pnpm go) runs Formbricks Hub on port 8080.
-# Override the default Hub API key (default: dev-api-key) when using docker-compose.dev.yml:
-# HUB_API_KEY=
+# The dev stack (pnpm db:up / pnpm go) runs Formbricks Hub on port 8080.
+# Set explicitly to avoid confusion; override as needed when using docker-compose.dev.yml.
+HUB_API_KEY=dev-api-key
+HUB_DATABASE_URL=postgresql://postgres:postgres@postgres:5432/postgres?schema=public&sslmode=disable
 
 ################
 #  MAIL SETUP  #
diff --git a/README.md b/README.md
index 145aec8bcd..1e8c7a61b0 100644
--- a/README.md
+++ b/README.md
@@ -169,7 +169,7 @@ Here is what you need to be able to run Formbricks:
 
 ### Local Setup
 
-To get started locally, we've got a [guide to help you](https://formbricks.com/docs/developer-docs/contributing/get-started#local-machine-setup). The dev stack (`pnpm db:up` or `pnpm go`) includes [Formbricks Hub](https://github.com/formbricks/hub) on port 8080; optional Hub env vars (e.g. `HUB_API_KEY`) are in `.env.example`. See [docker/README.md](docker/README.md#formbricks-hub) for details.
+To get started locally, we've got a [guide to help you](https://formbricks.com/docs/developer-docs/contributing/get-started#local-machine-setup).
 
 ### Gitpod Setup
 
diff --git a/docker-compose.dev.yml b/docker-compose.dev.yml
index d1608bbdd0..29510836db 100644
--- a/docker-compose.dev.yml
+++ b/docker-compose.dev.yml
@@ -1,7 +1,7 @@
 services:
   # PostgreSQL must load the vector library so Hub (and Formbricks) can use the pgvector extension.
   postgres:
-    image: pgvector/pgvector:pg17
+    image: pgvector/pgvector:pg18
     volumes:
       - postgres:/var/lib/postgresql/data
       - ./docker/postgres-init-dev:/docker-entrypoint-initdb.d:ro
diff --git a/docker/docker-compose.yml b/docker/docker-compose.yml
index 419510f64e..50225a65ec 100644
--- a/docker/docker-compose.yml
+++ b/docker/docker-compose.yml
@@ -29,6 +29,12 @@ x-environment: &environment
     # To use external Redis/Valkey: remove the redis service below and update this URL
     REDIS_URL: redis://redis:6379
 
+    # Formbricks Hub (port 8080): API key required. Use e.g. openssl rand -hex 32
+    HUB_API_KEY:
+
+    # Hub database URL (optional). Default: same Postgres as Formbricks. Set only if Hub uses a separate DB.
+    # HUB_DATABASE_URL:
+
     # Set the minimum log level(debug, info, warn, error, fatal)
     # LOG_LEVEL: info
 
@@ -202,7 +208,7 @@ x-environment: &environment
 services:
   postgres:
     restart: always
-    image: pgvector/pgvector:pg17
+    image: pgvector/pgvector:pg18
     volumes:
       - postgres:/var/lib/postgresql/data
     environment: