From 8e354bd003cabb01ac5f26dac3d4cb075968c618 Mon Sep 17 00:00:00 2001 From: akshat5302 Date: Mon, 16 Mar 2026 13:49:45 +0530 Subject: [PATCH 1/3] docs: emphasize the need for a separate database for Plane AI and clarify environment variable setup --- docs/self-hosting/govern/plane-ai.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/self-hosting/govern/plane-ai.md b/docs/self-hosting/govern/plane-ai.md index ca96c4b..1ed547e 100644 --- a/docs/self-hosting/govern/plane-ai.md +++ b/docs/self-hosting/govern/plane-ai.md @@ -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; do not use the same database as your main Plane application. - 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. @@ -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. ::: From 5864899e45fbf286857d0132d13bef23252fbe20 Mon Sep 17 00:00:00 2001 From: akshat5302 Date: Mon, 16 Mar 2026 13:58:45 +0530 Subject: [PATCH 2/3] docs: clarify the requirement for a separate database for Plane AI and improve wording in the documentation --- docs/self-hosting/govern/plane-ai.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/self-hosting/govern/plane-ai.md b/docs/self-hosting/govern/plane-ai.md index 1ed547e..fa98dd3 100644 --- a/docs/self-hosting/govern/plane-ai.md +++ b/docs/self-hosting/govern/plane-ai.md @@ -14,7 +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; do not use the same database as your main Plane application. +- 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. @@ -62,7 +62,7 @@ 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). +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 From 17ccf8cebac32fb6e702bc15afd34f485654f6df Mon Sep 17 00:00:00 2001 From: Dancia Date: Mon, 16 Mar 2026 13:59:45 +0530 Subject: [PATCH 3/3] Fix formatting in Plane AI database section Corrected formatting of the note about database isolation for Plane AI. --- docs/self-hosting/govern/plane-ai.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/self-hosting/govern/plane-ai.md b/docs/self-hosting/govern/plane-ai.md index fa98dd3..4b28817 100644 --- a/docs/self-hosting/govern/plane-ai.md +++ b/docs/self-hosting/govern/plane-ai.md @@ -62,7 +62,7 @@ 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). +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