Skip to content

docs:prerequisite the need for a separate database for Plane AI and clarify environment variable setup #244

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 3 commits into from
Mar 16, 2026
Merged

docs:prerequisite the need for a separate database for Plane AI and clarify environment variable setup #244

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
8e354bd
docs: emphasize the need for a separate database for Plane AI and cla…
akshat5302 Mar 16, 2026
5864899
docs: clarify the requirement for a separate database for Plane AI an…
akshat5302 Mar 16, 2026
17ccf8c
Fix formatting in Plane AI database section
danciaclara Mar 16, 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
5 changes: 5 additions & 0 deletions docs/self-hosting/govern/plane-ai.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ For an overview of what Plane AI can do, see the [Plane AI](https://docs.plane.s

You'll need:

- A **separate database** for Plane AI. Plane AI requires its own database instance.
- An OpenSearch instance running version 2.19 or later (self-hosted or AWS OpenSearch) configured for [advanced search](/self-hosting/govern/advanced-search).
- At least one LLM provider API key or a custom OpenAI-compatible endpoint.
- At least one embedding model configured in OpenSearch.
Expand Down Expand Up @@ -60,6 +61,10 @@ Embedding models power semantic search. Plane AI supports:

## Enable Plane AI services

:::info Separate database required
Plane AI must use its own database — do not share the main Plane application database. A dedicated database keeps AI data (e.g. chat history) isolated and avoids schema conflicts. Set **PLANE_PI_DATABASE_URL** (or the equivalent for your deployment). See the [environment variables reference](/self-hosting/govern/environment-variables#plane-ai).
:::

:::tip
For other deployment methods such as Coolify, Portainer, Docker Swarm, and Podman Quadlets, use the same [environment variables](/self-hosting/govern/environment-variables#plane-ai) defined for Docker Compose Setup.
:::
Expand Down
Loading