docs: reorganize database settings for Plane AI and update environment variable documentation

akshat5302 · akshat5302 · commit 45825f2b2fad · 2026-03-11T13:30:25.000+05:30
diff --git a/docs/self-hosting/govern/environment-variables.md b/docs/self-hosting/govern/environment-variables.md
@@ -87,8 +87,6 @@ This is where you'll make all configuration changes. Remember to restart the ins
 | **POSTGRES_PORT**         | TCP port your PostgreSQL server is listening on.                                                                                                                           | 5432                                       |
 | **PGDATA**                | Directory path where PostgreSQL data is stored. Only relevant if you're managing PostgreSQL within the same container/system.                                              | /var/lib/postgresql/data                   |
 | **DATABASE_URL**          | Full connection string for PostgreSQL. If provided, this takes precedence over individual connection parameters. Format: `postgresql://username:password@host:port/dbname` |                                            |
-| **FOLLOWER_POSTGRES_URI** | Connection string for a PostgreSQL read replica. Used for read-heavy operations to reduce load on the primary database.                                                    | Same as DATABASE_URL                       |
-| **PLANE_PI_DATABASE_URL** | Connection string for the Plane Intelligence database. A separate database used by the PI service.                                                                         | postgresql://plane:plane@plane-db/plane_pi |
 
 ### Redis settings
 
@@ -175,6 +173,13 @@ This is where you'll make all configuration changes. Remember to restart the ins
 
 ### Plane AI
 
+#### Database settings
+
+| Variable                  | Description                                                                                                                                                                | Default Value                       |
+| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- |
+| **FOLLOWER_POSTGRES_URI** | Connection string for a PostgreSQL read replica. Used for read-heavy operations to reduce load on the primary database.                                                    | Same as DATABASE_URL                |
+| **PLANE_PI_DATABASE_URL** | Connection string for the Plane Intelligence database. A separate database used by the PI service.                                                                         | postgresql://plane:plane@plane-db/plane_pi |
+
 #### Plane AI replicas
 
 To start Plane AI services, set each replica count to `1`:
diff --git a/docs/self-hosting/methods/install-methods-commercial/kubernetes.md b/docs/self-hosting/methods/install-methods-commercial/kubernetes.md
@@ -455,6 +455,7 @@ airgapped:
 | services.pi.annotations          |                        {}                        |          | Custom annotations to add to the Plane AI API deployment.                                                                                |
 | env.pg_pi_db_name                |                     plane_pi                     |          | PostgreSQL database name used by Plane AI when `postgres.local_setup=true`.                                                              |
 | env.pg_pi_db_remote_url          |                        ""                        |          | PostgreSQL connection URL for Plane AI when using a remote database. Required when `postgres.local_setup=false` and Plane AI is enabled. |
+| env.pi_envs.follower_postgres_uri |                Same as Plane DATABASE_URL                |   No    | Connection string for a Plane PostgreSQL DB read replica. Used for read-heavy operations to reduce load on the primary database.                   |
 | env.pi_envs.internal_secret      |        tyfvfqvBJAgpm9bzvf3r4urJer0Ehfdubk        |          | Internal secret used by Plane AI for OAuth and internal APIs.                                                                            |
 | env.pi_envs.plane_api_host       |                        ""                        |          | Override for the Plane API host URL used by Plane AI. Defaults to the license domain.                                                    |
 | env.pi_envs.cors_allowed_origins |                        ""                        |          | CORS allowed origins for Plane AI API. Defaults to the license domain.                                                                   |
diff --git a/docs/self-hosting/methods/kubernetes.md b/docs/self-hosting/methods/kubernetes.md
@@ -453,6 +453,7 @@ airgapped:
 | services.pi.annotations          |                        {}                        |          | Custom annotations to add to the Plane AI API deployment.                                                                                |
 | env.pg_pi_db_name                |                     plane_pi                     |          | PostgreSQL database name used by Plane AI when `postgres.local_setup=true`.                                                              |
 | env.pg_pi_db_remote_url          |                        ""                        |          | PostgreSQL connection URL for Plane AI when using a remote database. Required when `postgres.local_setup=false` and Plane AI is enabled. |
+| env.pi_envs.follower_postgres_uri |                Same as Plane DATABASE_URL                |   No    | Connection string for a Plane PostgreSQL DB read replica. Used for read-heavy operations to reduce load on the primary database.                                                   | 
 | env.pi_envs.internal_secret      |        tyfvfqvBJAgpm9bzvf3r4urJer0Ehfdubk        |          | Internal secret used by Plane AI for OAuth and internal APIs.                                                                            |
 | env.pi_envs.plane_api_host       |                        ""                        |          | Override for the Plane API host URL used by Plane AI. Defaults to the license domain.                                                    |
 | env.pi_envs.cors_allowed_origins |                        ""                        |          | CORS allowed origins for Plane AI API. Defaults to the license domain.                                                                   |
