Skip to content

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

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
danciaclara merged 8 commits into from
Mar 13, 2026
+82 −62
Merged

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

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
45825f2
docs: reorganize database settings for Plane AI and update environmen…
akshat5302 Mar 11, 2026
7e1a29c
docs: remove OPENSEARCH_ML_MODEL_ID from environment variables docume…
akshat5302 Mar 11, 2026
e329a21
docs: reorganize and restore database settings for Plane AI in enviro…
akshat5302 Mar 11, 2026
7d0c78a
docs: add FOLLOWER_POSTGRES_URI to environment variables documentatio…
akshat5302 Mar 11, 2026
005816c
docs: add description for FOLLOWER_POSTGRES_URI in Kubernetes environ…
akshat5302 Mar 11, 2026
685f48b
docs: add Plane AI database connection details to environment variabl…
akshat5302 Mar 11, 2026
69dc1b9
docs: add Plane AI database connection instructions to Kubernetes dep…
akshat5302 Mar 11, 2026
4a2a646
formatting fixes
danciaclara Mar 13, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 28 additions & 20 deletions docs/self-hosting/govern/environment-variables.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -77,18 +77,16 @@ This is where you'll make all configuration changes. Remember to restart the ins

### Database settings

| Variable | Description | Default Value |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
| **PGHOST** | Hostname or IP address of your PostgreSQL server. | plane-db |
| **PGDATABASE** | Name of the PostgreSQL database Plane will use. | plane |
| **POSTGRES_USER** | Username for PostgreSQL authentication. | plane |
| **POSTGRES_PASSWORD** | Password for PostgreSQL authentication. **Critical:** Use a strong, unique password here. | plane |
| **POSTGRES_DB** | Same as PGDATABASE - the name of the PostgreSQL database. | plane |
| **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 |
| Variable | Description | Default Value |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ |
| **PGHOST** | Hostname or IP address of your PostgreSQL server. | plane-db |
| **PGDATABASE** | Name of the PostgreSQL database Plane will use. | plane |
| **POSTGRES_USER** | Username for PostgreSQL authentication. | plane |
| **POSTGRES_PASSWORD** | Password for PostgreSQL authentication. **Critical:** Use a strong, unique password here. | plane |
| **POSTGRES_DB** | Same as PGDATABASE - the name of the PostgreSQL database. | plane |
| **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` | |

### Redis settings

Expand Down Expand Up @@ -164,14 +162,13 @@ This is where you'll make all configuration changes. Remember to restart the ins

### OpenSearch

| Variable | Description | Default Value |
| --------------------------- | --------------------------------------------------------------- | ------------------------------------ |
| **OPENSEARCH_ENABLED** | Enable OpenSearch integration | 1 |
| **OPENSEARCH_URL** | OpenSearch endpoint URL | https://opensearch.example.com:9200/ |
| **OPENSEARCH_USERNAME** | Authentication username | admin |
| **OPENSEARCH_PASSWORD** | Authentication password | your-secure-password |
| **OPENSEARCH_INDEX_PREFIX** | Prefix for all index names (useful for multi-tenant setups) | (empty) |
| **OPENSEARCH_ML_MODEL_ID** | OpenSearch ML model ID used for embedding-based search features | (empty) |
| Variable | Description | Default Value |
| --------------------------- | ----------------------------------------------------------- | ------------------------------------ |
| **OPENSEARCH_ENABLED** | Enable OpenSearch integration | 1 |
| **OPENSEARCH_URL** | OpenSearch endpoint URL | https://opensearch.example.com:9200/ |
| **OPENSEARCH_USERNAME** | Authentication username | admin |
| **OPENSEARCH_PASSWORD** | Authentication password | your-secure-password |
| **OPENSEARCH_INDEX_PREFIX** | Prefix for all index names (useful for multi-tenant setups) | (empty) |

### Plane AI

Expand All @@ -186,6 +183,17 @@ To start Plane AI services, set each replica count to `1`:
| **PI_WORKER_REPLICAS** | Plane AI Worker replica count | Yes |
| **PI_MIGRATOR_REPLICAS** | Plane AI Migrator replica count | Yes |

#### Database settings

::: info Plane AI database
Plane AI uses a separate PostgreSQL database. Create a new database (e.g. `plane_pi`) on your PostgreSQL server, then set **PLANE_PI_DATABASE_URL** to its connection string. Example: `postgresql://user:password@host:5432/plane_pi`
:::

| Variable | Description | Default Value |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
| **PLANE_PI_DATABASE_URL** | Connection string for the Plane AI database. A separate database used by the PI service. | postgresql://plane:plane@plane-db/plane_pi |
| **FOLLOWER_POSTGRES_URI** | Connection string for a Plane PostgreSQL DB read replica. Used for read-heavy operations to reduce load on the primary database. | Same as DATABASE_URL |

#### LLM provider API keys

Plane AI supports multiple LLM providers. Configure one or more by adding their API keys.
Expand Down
Loading
Loading