From 61183cffdc32b3b3eb99148c0aac335d8a83dcaa Mon Sep 17 00:00:00 2001 From: Ankit Sharma Date: Sun, 7 Jun 2026 09:20:45 +0530 Subject: [PATCH 01/11] docs: covert ascii diagram to mermaid flowchart - use mermaid flowchart replacing broken ascii diagram --- .../quick-start/connect-an-agent/index.md | 17 ++++++++++------- 1 file changed, 10 insertions(+), 7 deletions(-) diff --git a/docs/getting-started/quick-start/connect-an-agent/index.md b/docs/getting-started/quick-start/connect-an-agent/index.md index 405076140..b6bead9bc 100644 --- a/docs/getting-started/quick-start/connect-an-agent/index.md +++ b/docs/getting-started/quick-start/connect-an-agent/index.md @@ -41,13 +41,16 @@ The agent decides when and how to use these tools based on your message, and Ope Regardless of which agent you connect, the architecture is the same: -``` -┌──────────────┐ ┌──────────────────┐ ┌──────────────┐ -│ │ HTTP │ │ Tools │ │ -│ Open WebUI │────────▶│ Agent Gateway │────────▶│ Terminal, │ -│ (frontend) │◀────────│ (API server) │◀────────│ Files, Web │ -│ │ Stream │ │ Results│ │ -└──────────────┘ └──────────────────┘ └──────────────┘ +```mermaid +flowchart LR + A["Open WebUI
(frontend)"] + B["Agent Gateway
(API server)"] + C["Termainal,
Files, Web"] + + A -- HTTP --> B + B -- Tools --> C + C -- Results --> B + B -- Stream --> A ``` 1. **You type a message** in Open WebUI From d7946bd0e573ff06ec4df5f764f822130e84840a Mon Sep 17 00:00:00 2001 From: Ankit Sharma Date: Sun, 7 Jun 2026 09:59:24 +0530 Subject: [PATCH 02/11] docs: convert scaled deployment ascii diagram to mermaid flowchart - use mermaid flowchart replacing broken ascii diagram - use subgraphs for pods and shared infra node grouping - annotate nodes using dotted lines --- .../advanced-topics/scaling.md | 57 ++++++++++++------- 1 file changed, 36 insertions(+), 21 deletions(-) diff --git a/docs/getting-started/advanced-topics/scaling.md b/docs/getting-started/advanced-topics/scaling.md index 3d778ded5..b02872a4d 100644 --- a/docs/getting-started/advanced-topics/scaling.md +++ b/docs/getting-started/advanced-topics/scaling.md @@ -326,27 +326,42 @@ For the full setup guide, see [OpenTelemetry Monitoring](/reference/monitoring/o Here's what a production-ready scaled deployment typically looks like: -``` -┌─────────────────────────────────────────────────────┐ -│ Load Balancer │ -│ (Nginx, HAProxy, Cloud LB) │ -└──────────┬──────────┬──────────┬────────────────────┘ - │ │ │ - ┌─────▼──┐ ┌─────▼──┐ ┌────▼───┐ - │ WebUI │ │ WebUI │ │ WebUI │ ← Stateless containers - │ Pod 1 │ │ Pod 2 │ │ Pod N │ - └───┬────┘ └───┬────┘ └───┬────┘ - │ │ │ - ┌────▼──────────▼──────────▼────┐ - │ PostgreSQL │ ← Shared database - │ (+ PGVector for RAG) │ ← Vector DB (or other Vector DB) - └───────────────────────────────┘ - ┌───────────────────────────────┐ - │ Redis │ ← Shared state & websockets - └───────────────────────────────┘ - ┌───────────────────────────────┐ - │ Shared Storage (NFS or S3) │ ← Shared file storage - └───────────────────────────────┘ +```mermaid +flowchart TD + %% Main Flow + LB["Load Balancer
(Nginx, HAProxy, Cloud LB)"] + + subgraph Pods ["Stateless Containers"] + direction LR + P1["WebUI
Pod 1"] + P2["WebUI
Pod 2"] + PN["WebUI
Pod N"] + end + + subgraph Shared ["Shared Infrastructure"] + direction LR + DB[("PostgreSQL
(+ PGVector for RAG)")] + Redis{{"Redis"}} + Storage[/"Shared Storage
(NFS or S3)"/] + end + + %% Annotations + DBNote["Shared database
+ Vector DB"] + RedisNote["Shared state & websockets"] + StoreNote["Shared file storage"] + + %% Connections + LB --> P1 + LB --> P2 + LB --> PN + P1 --> Shared + P2 --> Shared + PN --> Shared + + %% Alignment Links + DB -.-> DBNote + Redis -.-> RedisNote + Storage -.-> StoreNote ``` **Running into issues?** The [Scaling & HA Troubleshooting](/troubleshooting/multi-replica) guide covers common problems (login loops, WebSocket failures, database locks, worker crashes) and their solutions. For performance tuning at scale, see [Optimization, Performance & RAM Usage](/troubleshooting/performance). From b6dff0e88b2ed4b0391895cba6f4a11719b945e7 Mon Sep 17 00:00:00 2001 From: Ankit Sharma Date: Sun, 7 Jun 2026 14:03:15 +0530 Subject: [PATCH 03/11] fix: fix terminal typo - change "Termainal" to "Terminal" --- docs/getting-started/quick-start/connect-an-agent/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/getting-started/quick-start/connect-an-agent/index.md b/docs/getting-started/quick-start/connect-an-agent/index.md index b6bead9bc..da43647db 100644 --- a/docs/getting-started/quick-start/connect-an-agent/index.md +++ b/docs/getting-started/quick-start/connect-an-agent/index.md @@ -45,7 +45,7 @@ Regardless of which agent you connect, the architecture is the same: flowchart LR A["Open WebUI
(frontend)"] B["Agent Gateway
(API server)"] - C["Termainal,
Files, Web"] + C["Terminal,
Files, Web"] A -- HTTP --> B B -- Tools --> C From ce96a2299885c859ebaf24eddaff7560ad1ebc92 Mon Sep 17 00:00:00 2001 From: Timothy Jaeryang Baek Date: Mon, 15 Jun 2026 07:44:46 +0200 Subject: [PATCH 04/11] refac --- docs/features/index.mdx | 4 + docs/features/open-terminal/index.md | 6 + .../use-cases/software-development.md | 4 + docs/getting-started/essentials.mdx | 4 + .../quick-start/connect-an-agent/cptr.mdx | 159 ++++++++++++++++++ .../quick-start/connect-an-agent/index.md | 1 + docs/intro.mdx | 2 +- 7 files changed, 179 insertions(+), 1 deletion(-) create mode 100644 docs/getting-started/quick-start/connect-an-agent/cptr.mdx diff --git a/docs/features/index.mdx b/docs/features/index.mdx index d03e67606..f081c2c9a 100644 --- a/docs/features/index.mdx +++ b/docs/features/index.mdx @@ -121,6 +121,10 @@ Connect a real computing environment to Open WebUI. The AI writes code, executes [**Learn about Open Terminal →**](/features/open-terminal) +:::tip +Want the whole machine in a browser tab? See [**cptr**](https://github.com/open-webui/computer) by the Open WebUI team. +::: + --- ## 🔌 Extensibility diff --git a/docs/features/open-terminal/index.md b/docs/features/open-terminal/index.md index 929f9d95f..44418d46f 100644 --- a/docs/features/open-terminal/index.md +++ b/docs/features/open-terminal/index.md @@ -84,3 +84,9 @@ Open Terminal requires models with **native function calling** support. Frontier ## Enterprise Multi-User Need isolated, per-user terminal containers for your team? **[Terminals](./terminals/)** provisions a dedicated Open Terminal instance for every user with automatic lifecycle management, resource controls, and policy-based environments. + +--- + +## Your Whole Machine + +Open Terminal adds a computing environment to Open WebUI. [**cptr**](https://github.com/open-webui/computer) by the Open WebUI team is the computer itself: files, terminal, git, editor, and AI in a browser tab, accessible from any device. diff --git a/docs/features/open-terminal/use-cases/software-development.md b/docs/features/open-terminal/use-cases/software-development.md index 411531e6d..48b77e4bf 100644 --- a/docs/features/open-terminal/use-cases/software-development.md +++ b/docs/features/open-terminal/use-cases/software-development.md @@ -7,6 +7,10 @@ title: "Software Development" Open Terminal enables the AI to interact with real codebases — cloning repos, running tests, reading errors, installing dependencies, and iterating on fixes. +:::tip +For a full development environment accessible from any device, see [**cptr**](https://github.com/open-webui/computer). Your computer in a browser tab. +::: + --- ## Clone and explore a repo diff --git a/docs/getting-started/essentials.mdx b/docs/getting-started/essentials.mdx index 5397e6331..b41becbe2 100644 --- a/docs/getting-started/essentials.mdx +++ b/docs/getting-started/essentials.mdx @@ -257,6 +257,10 @@ More detail: - [Open Terminal: give your AI a real computer](/features/open-terminal) - [Use cases: software development, data reports, app builder, research assistant, and more](/features/open-terminal/use-cases/advanced-workflows/) +:::info +[**cptr**](https://github.com/open-webui/computer) by the Open WebUI team is your entire computer in a browser tab: files, terminal, git, editor, and AI, accessible from any device. It connects to Open WebUI via its gateway API. +::: + --- ## What to do next diff --git a/docs/getting-started/quick-start/connect-an-agent/cptr.mdx b/docs/getting-started/quick-start/connect-an-agent/cptr.mdx new file mode 100644 index 000000000..d3f4af249 --- /dev/null +++ b/docs/getting-started/quick-start/connect-an-agent/cptr.mdx @@ -0,0 +1,159 @@ +--- +sidebar_position: 0 +title: "cptr" +--- + +# cptr + +**Connect cptr to Open WebUI.** + +[cptr](https://github.com/open-webui/computer) puts your computer in a browser tab. Files, terminal, git, editor, AI, accessible from any device. It runs on your machine and serves it to you over HTTP. + +cptr exposes an **OpenAI-compatible gateway API** (`/v1/chat/completions`). Each workspace appears as a model in Open WebUI with full tool access: file operations, terminal commands, web search, and more. + +:::info What You'll Need +- **cptr** installed on your machine (`pip install cptr` or `uvx cptr@latest run`) +- **Open WebUI** running (via Docker, pip, or desktop app) +- **~5 minutes** to complete this setup +::: + +--- + +## Step 1: Install and Start cptr + +If you haven't installed cptr yet: + +```bash +pip install cptr +cptr run +``` + +Or with [uv](https://docs.astral.sh/uv/): + +```bash +uvx cptr@latest run +``` + +cptr starts on port **8000** by default and opens in your browser. + +To allow access from other devices on the network: + +```bash +cptr run --host 0.0.0.0 +``` + +--- + +## Step 2: Create an API Key + +1. Open cptr in your browser. +2. Go to **Settings > Gateway**. +3. Enter a name for the key and click **Create Key**. +4. Copy the key (`sk-cptr-...`). You will only see it once. + +The Gateway settings page also shows the **Base URL** for your instance (e.g., `http://localhost:8000/v1`). + +--- + +## Step 3: Add the Connection in Open WebUI + +1. Open Open WebUI in your browser. +2. Go to ⚙️ **Admin Settings** > **Connections** > **OpenAI**. +3. Click ➕ **Add Connection**. +4. Enter the following: + +| Setting | Value | +|---|---| +| **URL** | `http://localhost:8000/v1` | +| **API Key** | The `sk-cptr-...` key from Step 2 | + +5. Click the ✅ checkmark to verify, then **Save**. + +:::tip Running Open WebUI in Docker? +Replace `localhost` with `host.docker.internal`: + +``` +http://host.docker.internal:8000/v1 +``` +::: + +--- + +## Step 4: Configure Custom Headers (Recommended) + +For the best experience, set up custom request headers so that Open WebUI passes conversation metadata to cptr. This enables proper session mapping (conversations stay in sync between both interfaces) and ensures background tasks like title generation are handled efficiently. + +1. In Open WebUI, go to **Admin Settings > Connections**. +2. Find the cptr connection and click the **⋮** menu, then **Custom Headers**. +3. Paste the following: + +```json +{ + "X-OpenWebUI-Chat-Id": "{{CHAT_ID}}", + "X-OpenWebUI-Message-Id": "{{MESSAGE_ID}}", + "X-OpenWebUI-User-Message-Id": "{{USER_MESSAGE_ID}}", + "X-OpenWebUI-User-Message-Parent-Id": "{{USER_MESSAGE_PARENT_ID}}", + "X-OpenWebUI-Task": "{{TASK}}" +} +``` + +:::tip +You can copy these headers directly from cptr's **Settings > Gateway** page. +::: + +--- + +## Step 5: Start Chatting + +Your cptr workspaces should now appear in the model dropdown as `cptr/`. Select one and start chatting. The AI has full access to that workspace: files, terminal, web search, and any configured tools. + +Conversations are synced. Work done through Open WebUI appears in cptr's sidebar, and vice versa. + +--- + +## Choosing a Gateway Model + +By default, cptr uses the first available model connection for gateway requests. To use a specific model: + +1. In cptr, go to **Settings > Gateway**. +2. Select a model from the dropdown. +3. Click **Save**. + +You can also set a per-workspace model by creating a `.cptr/model` file in the workspace root: + +```bash +echo "anthropic/claude-sonnet-4-20250514" > /path/to/workspace/.cptr/model +``` + +--- + +## Troubleshooting + +### No models appear in the dropdown + +- Verify the URL includes `/v1`: `http://localhost:8000/v1` (not just `:8000`) +- Check that cptr is running and accessible +- Confirm the API key is correct + +### Connection test passes but no models load + +Almost always the missing `/v1` suffix. Open WebUI's connection test checks basic connectivity, not model discovery. + +### Docker networking issues + +If Open WebUI runs in Docker, `localhost` points to the container itself. Use `host.docker.internal` instead. On Linux without Docker Desktop: + +```bash +docker run --add-host=host.docker.internal:host-gateway ... +``` + +### Conversations not syncing + +Make sure the custom headers from Step 4 are configured. Without them, cptr creates a new chat for each request instead of continuing the existing conversation. + +--- + +## Learn More + +- [cptr on GitHub](https://github.com/open-webui/computer) +- [Open WebUI Connections](/getting-started/quick-start/connect-a-provider/starting-with-openai-compatible) diff --git a/docs/getting-started/quick-start/connect-an-agent/index.md b/docs/getting-started/quick-start/connect-an-agent/index.md index da43647db..e720af5ec 100644 --- a/docs/getting-started/quick-start/connect-an-agent/index.md +++ b/docs/getting-started/quick-start/connect-an-agent/index.md @@ -32,6 +32,7 @@ The agent decides when and how to use these tools based on your message, and Ope | Agent | Description | Guide | |-------|-------------|-------| +| **cptr** | Your computer in a browser tab. Each workspace connects to Open WebUI as a model with full tool access via an OpenAI-compatible gateway. | [Set up cptr →](./cptr) | | **Hermes Agent** | Autonomous agent by Nous Research with terminal, file ops, web search, memory, and extensible skills | [Set up Hermes Agent →](./hermes-agent) | | **OpenClaw** | Open-source self-hosted agent framework with shell access, file operations, web browsing, and messaging channel integrations | [Set up OpenClaw →](./openclaw) | diff --git a/docs/intro.mdx b/docs/intro.mdx index 343941458..eb9350215 100644 --- a/docs/intro.mdx +++ b/docs/intro.mdx @@ -78,7 +78,7 @@ Installed Open WebUI but not sure where to start? The [**Essentials for Open Web - [**Quick Start**](/getting-started/quick-start) — Docker, Python, Kubernetes install options - [**Connect a Provider**](/getting-started/quick-start/connect-a-provider) — Ollama, OpenAI, Anthropic, vLLM, and more - [**Essentials for Open WebUI**](/getting-started/essentials) - Start here after your first install. Plugins, tool calling, task models, context management, RAG, Open Terminal. -- [**Connect an Agent**](/getting-started/quick-start/connect-an-agent) — Hermes Agent, OpenClaw, and other autonomous AI agents +- [**Connect an Agent**](/getting-started/quick-start/connect-an-agent) — cptr, Hermes Agent, OpenClaw, and other autonomous AI agents - [**Updating**](/getting-started/updating) — Keep your instance current - [**Development Branch**](/getting-started/quick-start) — Help test the latest changes before stable release - [**Advanced Topics**](/getting-started/advanced-topics) — Scaling, logging, and advanced configuration From 73cf6b0641604e655b3e133fae8decb7f413a342 Mon Sep 17 00:00:00 2001 From: Timothy Jaeryang Baek Date: Mon, 15 Jun 2026 08:04:45 +0200 Subject: [PATCH 05/11] refac --- docs/getting-started/quick-start/connect-an-agent/index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/getting-started/quick-start/connect-an-agent/index.md b/docs/getting-started/quick-start/connect-an-agent/index.md index e720af5ec..818f9c789 100644 --- a/docs/getting-started/quick-start/connect-an-agent/index.md +++ b/docs/getting-started/quick-start/connect-an-agent/index.md @@ -32,9 +32,9 @@ The agent decides when and how to use these tools based on your message, and Ope | Agent | Description | Guide | |-------|-------------|-------| -| **cptr** | Your computer in a browser tab. Each workspace connects to Open WebUI as a model with full tool access via an OpenAI-compatible gateway. | [Set up cptr →](./cptr) | -| **Hermes Agent** | Autonomous agent by Nous Research with terminal, file ops, web search, memory, and extensible skills | [Set up Hermes Agent →](./hermes-agent) | -| **OpenClaw** | Open-source self-hosted agent framework with shell access, file operations, web browsing, and messaging channel integrations | [Set up OpenClaw →](./openclaw) | +| **cptr** | Your computer in a browser tab, by the Open WebUI team. Each workspace connects to Open WebUI as a model with full tool access via an OpenAI-compatible gateway. | [Set up cptr →](/getting-started/quick-start/connect-an-agent/cptr) | +| **Hermes Agent** | Autonomous agent by Nous Research with terminal, file ops, web search, memory, and extensible skills | [Set up Hermes Agent →](/getting-started/quick-start/connect-an-agent/hermes-agent) | +| **OpenClaw** | Open-source self-hosted agent framework with shell access, file operations, web browsing, and messaging channel integrations | [Set up OpenClaw →](/getting-started/quick-start/connect-an-agent/openclaw) | --- From b2bc8d4a17843f768c9283464d580c045c2ede20 Mon Sep 17 00:00:00 2001 From: Timothy Jaeryang Baek Date: Mon, 15 Jun 2026 08:08:12 +0200 Subject: [PATCH 06/11] refac --- docs/features/open-terminal/file-browser.md | 4 ++++ docs/features/open-terminal/setup/installation.mdx | 4 ++++ docs/features/open-terminal/use-cases/code-execution.md | 4 ++++ docs/features/open-terminal/use-cases/system-automation.md | 4 ++++ docs/features/open-terminal/use-cases/web-development.md | 4 ++++ 5 files changed, 20 insertions(+) diff --git a/docs/features/open-terminal/file-browser.md b/docs/features/open-terminal/file-browser.md index d115dad50..f51a0b301 100644 --- a/docs/features/open-terminal/file-browser.md +++ b/docs/features/open-terminal/file-browser.md @@ -109,3 +109,7 @@ If you have more than one terminal connected, switching between them in the drop - **[Analyze documents & data →](./use-cases/file-analysis)** — drag in a spreadsheet or PDF and ask about it - **[Run code from chat →](./use-cases/code-execution)** — the AI creates files you can see here - **[Build & preview websites →](./use-cases/web-development)** — the files the AI creates appear in the browser + +:::tip +Want to browse and edit your real files from any device? [**cptr**](https://github.com/open-webui/computer) puts your entire machine in a browser tab, with a full file browser, terminal, git, and editor. +::: diff --git a/docs/features/open-terminal/setup/installation.mdx b/docs/features/open-terminal/setup/installation.mdx index 3f30a9f8e..804fceac8 100644 --- a/docs/features/open-terminal/setup/installation.mdx +++ b/docs/features/open-terminal/setup/installation.mdx @@ -154,6 +154,10 @@ http://open-terminal:8000 --- +:::tip Looking for the whole machine? +[**cptr**](https://github.com/open-webui/computer) by the Open WebUI team is your entire computer in a browser tab: files, terminal, git, editor, and AI, accessible from any device. It also connects to Open WebUI via its gateway API. +::: + ## Next step [**Connect to Open WebUI →**](./connecting) diff --git a/docs/features/open-terminal/use-cases/code-execution.md b/docs/features/open-terminal/use-cases/code-execution.md index 21304e132..761a1dc61 100644 --- a/docs/features/open-terminal/use-cases/code-execution.md +++ b/docs/features/open-terminal/use-cases/code-execution.md @@ -88,3 +88,7 @@ Additional languages (Rust, Go, Java, etc.) can be installed on the fly. - **[Document & data analysis →](./file-analysis)** — spreadsheets, PDFs, Word docs - **[Web development →](./web-development)** — build and preview websites - **[System automation →](./system-automation)** — file management, backups, batch operations + +:::tip +Want a persistent environment on your real machine? [**cptr**](https://github.com/open-webui/computer) puts your computer in a browser tab, accessible from any device. +::: diff --git a/docs/features/open-terminal/use-cases/system-automation.md b/docs/features/open-terminal/use-cases/system-automation.md index ddc49f157..596caac5e 100644 --- a/docs/features/open-terminal/use-cases/system-automation.md +++ b/docs/features/open-terminal/use-cases/system-automation.md @@ -85,3 +85,7 @@ If a tool isn't installed, the AI can install it on the fly (`sudo apt install . - **[Run code from chat →](./code-execution)** — the AI writes, runs, and debugs code - **[Analyze documents & data →](./file-analysis)** — spreadsheets, PDFs, Word docs, emails - **[Build & preview websites →](./web-development)** — create and iterate on web pages + +:::tip +Want to automate tasks on your real machine from anywhere? [**cptr**](https://github.com/open-webui/computer) puts your computer in a browser tab, accessible from any device. +::: diff --git a/docs/features/open-terminal/use-cases/web-development.md b/docs/features/open-terminal/use-cases/web-development.md index 2503a87b7..5fad7e52f 100644 --- a/docs/features/open-terminal/use-cases/web-development.md +++ b/docs/features/open-terminal/use-cases/web-development.md @@ -86,3 +86,7 @@ If the AI starts more than one server (say, a frontend on port 3000 and a backen - **[Run code from chat →](./code-execution)** — the AI writes, runs, and debugs code - **[Analyze documents & data →](./file-analysis)** — spreadsheets, PDFs, Word docs, emails - **[Automate tasks →](./system-automation)** — file management, backups, batch operations + +:::tip +Want to preview and iterate on websites from your phone? [**cptr**](https://github.com/open-webui/computer) gives you your whole machine in a browser tab, accessible from any device. +::: From f763eb6e356143141bc89ecc7c2553b65e35d867 Mon Sep 17 00:00:00 2001 From: Timothy Jaeryang Baek Date: Mon, 15 Jun 2026 09:18:32 +0200 Subject: [PATCH 07/11] refac --- docs/intro.mdx | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/intro.mdx b/docs/intro.mdx index eb9350215..86e960b17 100644 --- a/docs/intro.mdx +++ b/docs/intro.mdx @@ -95,6 +95,15 @@ Installed Open WebUI but not sure where to start? The [**Essentials for Open Web --- +## Also by Open WebUI + +- [**cptr**](https://github.com/open-webui/computer) — Your computer in a browser tab. Files, terminal, git, editor, and AI, accessible from any device. [Connect it to Open WebUI →](/getting-started/quick-start/connect-an-agent/cptr) +- [**open-terminal**](https://github.com/open-webui/open-terminal) — Give your AI a real computer. Sandboxed terminal, file browser, and code execution for Open WebUI. +- [**oikb**](https://github.com/open-webui/oikb) — Keep your knowledge bases in sync. Watches local folders, GitHub repos, S3 buckets, Confluence, and 40+ other sources. +- [**mcpo**](https://github.com/open-webui/mcpo) — MCP-to-OpenAPI proxy. Use any MCP tool server with Open WebUI (or any OpenAPI client) without custom glue code. + +--- + ## Enterprise Need **custom branding**, **SLA support**, or **Long-Term Support (LTS)** versions? From f0bab2c56dad43ba902406304d3a5bc9718e8e25 Mon Sep 17 00:00:00 2001 From: Timothy Jaeryang Baek Date: Mon, 15 Jun 2026 12:22:42 +0200 Subject: [PATCH 08/11] refac --- docs/features/index.mdx | 2 +- docs/features/open-terminal/index.md | 2 +- docs/features/open-terminal/setup/installation.mdx | 2 +- docs/getting-started/essentials.mdx | 2 +- .../quick-start/connect-an-agent/cptr.mdx | 9 +++++---- .../quick-start/connect-an-agent/index.md | 2 +- docs/intro.mdx | 2 +- 7 files changed, 11 insertions(+), 10 deletions(-) diff --git a/docs/features/index.mdx b/docs/features/index.mdx index f081c2c9a..c1a300565 100644 --- a/docs/features/index.mdx +++ b/docs/features/index.mdx @@ -122,7 +122,7 @@ Connect a real computing environment to Open WebUI. The AI writes code, executes [**Learn about Open Terminal →**](/features/open-terminal) :::tip -Want the whole machine in a browser tab? See [**cptr**](https://github.com/open-webui/computer) by the Open WebUI team. +Want the whole machine in a browser tab? See [**cptr**](https://github.com/open-webui/computer) (Open WebUI Computer). ::: --- diff --git a/docs/features/open-terminal/index.md b/docs/features/open-terminal/index.md index 44418d46f..bfcd75a29 100644 --- a/docs/features/open-terminal/index.md +++ b/docs/features/open-terminal/index.md @@ -89,4 +89,4 @@ Need isolated, per-user terminal containers for your team? **[Terminals](./termi ## Your Whole Machine -Open Terminal adds a computing environment to Open WebUI. [**cptr**](https://github.com/open-webui/computer) by the Open WebUI team is the computer itself: files, terminal, git, editor, and AI in a browser tab, accessible from any device. +Open Terminal adds a computing environment to Open WebUI. [**cptr**](https://github.com/open-webui/computer) (Open WebUI Computer) is the computer itself: files, terminal, git, editor, and AI in a browser tab, accessible from any device. diff --git a/docs/features/open-terminal/setup/installation.mdx b/docs/features/open-terminal/setup/installation.mdx index 804fceac8..e8fd2eca6 100644 --- a/docs/features/open-terminal/setup/installation.mdx +++ b/docs/features/open-terminal/setup/installation.mdx @@ -155,7 +155,7 @@ http://open-terminal:8000 --- :::tip Looking for the whole machine? -[**cptr**](https://github.com/open-webui/computer) by the Open WebUI team is your entire computer in a browser tab: files, terminal, git, editor, and AI, accessible from any device. It also connects to Open WebUI via its gateway API. +[**cptr**](https://github.com/open-webui/computer) (Open WebUI Computer) is your entire computer in a browser tab: files, terminal, git, editor, and AI, accessible from any device. It also connects to Open WebUI via its gateway API. ::: ## Next step diff --git a/docs/getting-started/essentials.mdx b/docs/getting-started/essentials.mdx index b41becbe2..b8736b836 100644 --- a/docs/getting-started/essentials.mdx +++ b/docs/getting-started/essentials.mdx @@ -258,7 +258,7 @@ More detail: - [Use cases: software development, data reports, app builder, research assistant, and more](/features/open-terminal/use-cases/advanced-workflows/) :::info -[**cptr**](https://github.com/open-webui/computer) by the Open WebUI team is your entire computer in a browser tab: files, terminal, git, editor, and AI, accessible from any device. It connects to Open WebUI via its gateway API. +[**cptr**](https://github.com/open-webui/computer) (Open WebUI Computer) by the Open WebUI team is your entire computer in a browser tab: files, terminal, git, editor, and AI, accessible from any device. It connects to Open WebUI via its gateway API. ::: --- diff --git a/docs/getting-started/quick-start/connect-an-agent/cptr.mdx b/docs/getting-started/quick-start/connect-an-agent/cptr.mdx index d3f4af249..e88c404a3 100644 --- a/docs/getting-started/quick-start/connect-an-agent/cptr.mdx +++ b/docs/getting-started/quick-start/connect-an-agent/cptr.mdx @@ -1,13 +1,14 @@ --- sidebar_position: 0 -title: "cptr" +title: "Open WebUI Computer (cptr)" +sidebar_label: "Open WebUI Computer (cptr)" --- -# cptr +# Open WebUI Computer (cptr) -**Connect cptr to Open WebUI.** +**Open WebUI Computer. Connect `cptr` to Open WebUI.** -[cptr](https://github.com/open-webui/computer) puts your computer in a browser tab. Files, terminal, git, editor, AI, accessible from any device. It runs on your machine and serves it to you over HTTP. +[**cptr**](https://github.com/open-webui/computer) puts your computer in a browser tab. Files, terminal, git, editor, AI, accessible from any device. It runs on your machine and serves it to you over HTTP. cptr exposes an **OpenAI-compatible gateway API** (`/v1/chat/completions`). Each workspace appears as a model in Open WebUI with full tool access: file operations, terminal commands, web search, and more. diff --git a/docs/getting-started/quick-start/connect-an-agent/index.md b/docs/getting-started/quick-start/connect-an-agent/index.md index 818f9c789..71ef61aad 100644 --- a/docs/getting-started/quick-start/connect-an-agent/index.md +++ b/docs/getting-started/quick-start/connect-an-agent/index.md @@ -32,7 +32,7 @@ The agent decides when and how to use these tools based on your message, and Ope | Agent | Description | Guide | |-------|-------------|-------| -| **cptr** | Your computer in a browser tab, by the Open WebUI team. Each workspace connects to Open WebUI as a model with full tool access via an OpenAI-compatible gateway. | [Set up cptr →](/getting-started/quick-start/connect-an-agent/cptr) | +| **cptr** (Open WebUI Computer) | Your computer in a browser tab, by the Open WebUI team. Each workspace connects to Open WebUI as a model with full tool access via an OpenAI-compatible gateway. | [Set up cptr →](/getting-started/quick-start/connect-an-agent/cptr) | | **Hermes Agent** | Autonomous agent by Nous Research with terminal, file ops, web search, memory, and extensible skills | [Set up Hermes Agent →](/getting-started/quick-start/connect-an-agent/hermes-agent) | | **OpenClaw** | Open-source self-hosted agent framework with shell access, file operations, web browsing, and messaging channel integrations | [Set up OpenClaw →](/getting-started/quick-start/connect-an-agent/openclaw) | diff --git a/docs/intro.mdx b/docs/intro.mdx index 86e960b17..36a8c4b1b 100644 --- a/docs/intro.mdx +++ b/docs/intro.mdx @@ -97,7 +97,7 @@ Installed Open WebUI but not sure where to start? The [**Essentials for Open Web ## Also by Open WebUI -- [**cptr**](https://github.com/open-webui/computer) — Your computer in a browser tab. Files, terminal, git, editor, and AI, accessible from any device. [Connect it to Open WebUI →](/getting-started/quick-start/connect-an-agent/cptr) +- [**cptr**](https://github.com/open-webui/computer) (Open WebUI Computer) — Your computer in a browser tab. Files, terminal, git, editor, and AI, accessible from any device. [Connect it to Open WebUI →](/getting-started/quick-start/connect-an-agent/cptr) - [**open-terminal**](https://github.com/open-webui/open-terminal) — Give your AI a real computer. Sandboxed terminal, file browser, and code execution for Open WebUI. - [**oikb**](https://github.com/open-webui/oikb) — Keep your knowledge bases in sync. Watches local folders, GitHub repos, S3 buckets, Confluence, and 40+ other sources. - [**mcpo**](https://github.com/open-webui/mcpo) — MCP-to-OpenAPI proxy. Use any MCP tool server with Open WebUI (or any OpenAPI client) without custom glue code. From c47e3f5767993a3813f071593abde72ee9d7fdcf Mon Sep 17 00:00:00 2001 From: Timothy Jaeryang Baek Date: Mon, 15 Jun 2026 12:29:50 +0200 Subject: [PATCH 09/11] refac --- docs/intro.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/intro.mdx b/docs/intro.mdx index 36a8c4b1b..b949c452a 100644 --- a/docs/intro.mdx +++ b/docs/intro.mdx @@ -99,7 +99,7 @@ Installed Open WebUI but not sure where to start? The [**Essentials for Open Web - [**cptr**](https://github.com/open-webui/computer) (Open WebUI Computer) — Your computer in a browser tab. Files, terminal, git, editor, and AI, accessible from any device. [Connect it to Open WebUI →](/getting-started/quick-start/connect-an-agent/cptr) - [**open-terminal**](https://github.com/open-webui/open-terminal) — Give your AI a real computer. Sandboxed terminal, file browser, and code execution for Open WebUI. -- [**oikb**](https://github.com/open-webui/oikb) — Keep your knowledge bases in sync. Watches local folders, GitHub repos, S3 buckets, Confluence, and 40+ other sources. +- [**oikb**](https://github.com/open-webui/oikb) — Keep your Open WebUI knowledge bases in sync. Watches local folders, GitHub repos, S3 buckets, Confluence, and 40+ other sources. - [**mcpo**](https://github.com/open-webui/mcpo) — MCP-to-OpenAPI proxy. Use any MCP tool server with Open WebUI (or any OpenAPI client) without custom glue code. --- From a84aad02cdac71a8e2e5fc4e2b0751f85c0a766a Mon Sep 17 00:00:00 2001 From: Timothy Jaeryang Baek Date: Mon, 15 Jun 2026 12:35:52 +0200 Subject: [PATCH 10/11] refac --- docs/intro.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/intro.mdx b/docs/intro.mdx index b949c452a..6d8af6e09 100644 --- a/docs/intro.mdx +++ b/docs/intro.mdx @@ -78,7 +78,7 @@ Installed Open WebUI but not sure where to start? The [**Essentials for Open Web - [**Quick Start**](/getting-started/quick-start) — Docker, Python, Kubernetes install options - [**Connect a Provider**](/getting-started/quick-start/connect-a-provider) — Ollama, OpenAI, Anthropic, vLLM, and more - [**Essentials for Open WebUI**](/getting-started/essentials) - Start here after your first install. Plugins, tool calling, task models, context management, RAG, Open Terminal. -- [**Connect an Agent**](/getting-started/quick-start/connect-an-agent) — cptr, Hermes Agent, OpenClaw, and other autonomous AI agents +- [**Connect an Agent**](/getting-started/quick-start/connect-an-agent) — Open WebUI Computer (`cptr`), Hermes Agent, OpenClaw, and other autonomous AI agents - [**Updating**](/getting-started/updating) — Keep your instance current - [**Development Branch**](/getting-started/quick-start) — Help test the latest changes before stable release - [**Advanced Topics**](/getting-started/advanced-topics) — Scaling, logging, and advanced configuration From b9ee002e51159a215a0f292f559cc76ee883f7d2 Mon Sep 17 00:00:00 2001 From: Timothy Jaeryang Baek Date: Tue, 16 Jun 2026 16:04:17 +0200 Subject: [PATCH 11/11] refac --- docs/getting-started/index.md | 16 +++++++ docs/getting-started/open-webui-as-app.md | 56 +++++++++++++++++++++++ 2 files changed, 72 insertions(+) create mode 100644 docs/getting-started/open-webui-as-app.md diff --git a/docs/getting-started/index.md b/docs/getting-started/index.md index 0a8c33b6a..a6ba97f18 100644 --- a/docs/getting-started/index.md +++ b/docs/getting-started/index.md @@ -30,6 +30,22 @@ Everything you need for a working setup. Choose Docker for the fastest path, Pyt --- +## 📱 Open WebUI as an App + +**Already running Open WebUI? Install it as an app on any device.** + +Open WebUI is a Progressive Web App (PWA). Add it to your phone's home screen, your desktop taskbar, or your dock. No separate download required. Get a full-screen, native-feeling experience from any browser. + +| | | +| :--- | :--- | +| 📱 **iPhone / iPad** | Share → Add to Home Screen | +| 🤖 **Android** | Menu → Install app | +| 🖥️ **Chrome / Edge** | Address bar install icon | + +[**Install as an app →**](/getting-started/open-webui-as-app) + +--- + ## Essentials for Open WebUI **Installed and chatting — now what?** diff --git a/docs/getting-started/open-webui-as-app.md b/docs/getting-started/open-webui-as-app.md new file mode 100644 index 000000000..6c0f9a96d --- /dev/null +++ b/docs/getting-started/open-webui-as-app.md @@ -0,0 +1,56 @@ +--- +sidebar_position: 3 +title: "Open WebUI as an App" +--- + +# Open WebUI as an App + +Every Open WebUI instance is a **Progressive Web App (PWA)**. You can install it as a standalone app on your phone, tablet, or desktop, directly from the browser. No separate download required. + +## What You Get + +- **App icon** on your home screen, taskbar, or dock +- **Full-screen experience** with no browser toolbar or address bar +- **Standalone window** on desktop, full-screen on mobile +- **Separate from the browser** with its own window and task entry +- **Push notifications** (when enabled by your admin) + +--- + +## Install on Your Device + +### Chrome / Edge (Desktop) + +1. Open your Open WebUI instance in Chrome or Edge. +2. Click the **install icon** (⊕) in the address bar, or go to **Menu → Install Open WebUI**. +3. Click **Install**. + +Open WebUI now appears in your app launcher and runs in its own window. + +### Chrome (Android) + +1. Open your Open WebUI instance in Chrome. +2. Tap **Menu (⋮) → Add to Home Screen** or **Install app**. +3. Tap **Install**. + +### Safari (iPhone / iPad) + +1. Open your Open WebUI instance in Safari. +2. Tap the **Share button** (↑). +3. Scroll down and tap **Add to Home Screen**. +4. Tap **Add**. + +:::info +Safari is the only browser that supports PWA installation on iOS. Chrome and Firefox on iOS cannot install PWAs. +::: + +### Firefox (Android) + +1. Open your Open WebUI instance in Firefox. +2. Tap **Menu (⋮) → Install**. + +--- + +## Customizing the PWA (Admins) + +Admins can white-label the PWA by pointing to a custom manifest with the [`EXTERNAL_PWA_MANIFEST_URL`](/reference/env-configuration#external_pwa_manifest_url) environment variable. This lets you set a custom app name, icon, and theme color.