Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
16 changes: 10 additions & 6 deletions docs/self-hosting/govern/environment-variables.md
Original file line number Diff line number Diff line change
Expand Up @@ -202,6 +202,7 @@ Plane AI supports multiple LLM providers. Configure one or more by adding their
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | -------- |
| **OPENAI_API_KEY** | API key for OpenAI models | Optional |
| **CLAUDE_API_KEY** | API key for Anthropic models | Optional |
| **BASETEN_API_KEY** | API key for Baseten models (Kimi K2.6, GLM 5.2, DeepSeek V4). Requires `BASETEN_BASE_URL`. | Optional |
| **GROQ_API_KEY** | API key for speech-to-text features | Optional |
| **CUSTOM_LLM_ENABLED** | Set to `true` to enable a custom LLM. Supports OpenAI-compatible endpoints and AWS Bedrock. | Optional |
| **CUSTOM_LLM_PROVIDER** | Backend provider for the custom model. Accepted values: `openai` (default), `bedrock`. | Optional |
Expand All @@ -216,12 +217,13 @@ Plane AI supports multiple LLM providers. Configure one or more by adding their

Use these when routing requests through self-hosted gateways, proxies, or compatible third-party endpoints.

| Variable | Description | Default |
| ------------------- | ------------------------------------------ | --------- |
| **OPENAI_BASE_URL** | Custom base URL for OpenAI-compatible APIs | OpenAI |
| **CLAUDE_BASE_URL** | Custom base URL for Claude-compatible APIs | Anthropic |
| **COHERE_BASE_URL** | Custom base URL for Cohere APIs | Cohere |
| **GROQ_BASE_URL** | Custom base URL for Groq APIs | Groq |
| Variable | Description | Default |
| -------------------- | ------------------------------------------ | --------------------------------- |
| **OPENAI_BASE_URL** | Custom base URL for OpenAI-compatible APIs | OpenAI |
| **CLAUDE_BASE_URL** | Custom base URL for Claude-compatible APIs | Anthropic |
| **BASETEN_BASE_URL** | Base URL for Baseten APIs | `https://inference.baseten.co/v1` |
| **COHERE_BASE_URL** | Custom base URL for Cohere APIs | Cohere |
| **GROQ_BASE_URL** | Custom base URL for Groq APIs | Groq |

#### Embedding model configuration

Expand Down Expand Up @@ -299,6 +301,8 @@ For setup instructions, supported models, and IAM permissions, see [Configure Pl
| **OPENAI_BASE_URL** | Custom base URL for OpenAI-compatible API endpoints. | |
| **CLAUDE_API_KEY** | API key for Anthropic Claude services used by Plane Intelligence. | |
| **CLAUDE_BASE_URL** | Custom base URL for Claude API endpoints. | |
| **BASETEN_API_KEY** | API key for Baseten services (Kimi K2.6, GLM 5.2, DeepSeek V4) used by Plane Intelligence. Requires `BASETEN_BASE_URL`. | |
| **BASETEN_BASE_URL** | Base URL for Baseten API endpoints. | `https://inference.baseten.co/v1` |
| **GROQ_API_KEY** | API key for Groq services used by Plane Intelligence. | |
| **GROQ_BASE_URL** | Custom base URL for Groq API endpoints. | |
| **COHERE_API_KEY** | API key for Cohere services used by Plane Intelligence. | |
Expand Down
24 changes: 21 additions & 3 deletions docs/self-hosting/govern/plane-ai/configure-plane-ai.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: Configure Plane AI
description: Enable Plane AI on your self-hosted instance. Set up a dedicated database, configure OpenSearch, add an LLM API key, and connect PI to your Plane deployment.
keywords: plane ai setup, self-hosted ai, llm api key, openai, anthropic, opensearch, enable plane ai
keywords: plane ai setup, self-hosted ai, llm api key, openai, anthropic, baseten, kimi, glm, deepseek, opensearch, enable plane ai
---

# Configure Plane AI <Badge type="info" text="Commercial Edition" />
Expand All @@ -14,7 +14,7 @@ For an overview of what Plane AI can do, see [Plane AI](https://docs.plane.so/ai

Plane AI requires four things to work:

1. **An LLM API key** (OpenAI or Anthropic) - powers AI responses.
1. **An LLM API key** (OpenAI, Anthropic, or Baseten) - powers AI responses.
2. **OpenSearch** - An OpenSearch instance running version 2.19 or later (self-hosted or AWS OpenSearch) configured for [advanced search](/self-hosting/govern/advanced-search). Search over your workspace data (work items, pages, cycles) runs through OpenSearch indices.
3. **A dedicated database** - Plane AI must not share the main Plane application database.
4. **Read access to the main Plane database** - PI reads workspace data directly from the main Plane DB.
Expand All @@ -30,8 +30,15 @@ Plane AI requires four things to work:

- Claude Sonnet 4.5
- Claude Sonnet 4.6
- Claude Sonnet 5

You can provide API keys for both OpenAI and Anthropic, making all models available to users. If you provide only one key, users will only have access to that provider's models.
### Baseten

- Kimi K2.6
- GLM 5.2
- DeepSeek V4

You can provide API keys for any combination of OpenAI, Anthropic, and Baseten, making those models available to users. If you provide only one key, users will only have access to that provider's models.

:::tip Custom or self-hosted models
To use Ollama, Groq, LiteLLM, AWS Bedrock, or any OpenAI-compatible endpoint, see [Custom LLM models](#custom-llm-models).
Expand Down Expand Up @@ -72,6 +79,17 @@ OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx
CLAUDE_API_KEY=xxxxxxxxxxxxxxxx
```

### Baseten

Baseten serves Kimi K2.6, GLM 5.2, and DeepSeek V4 through an OpenAI-compatible endpoint. Add both the API key and base URL to `/opt/plane/plane.env`:

```bash
BASETEN_API_KEY=xxxxxxxxxxxxxxxx
BASETEN_BASE_URL=https://inference.baseten.co/v1
```

Both variables are required to enable Baseten models. Get an API key from the [Baseten dashboard](https://app.baseten.co/settings/api_keys).

### Custom LLM models

:::warning
Expand Down
Loading