From 92a7d503a6b3e56c45d0529ce518358011e736a9 Mon Sep 17 00:00:00 2001
From: Frankie Seabrook <fifthfrankie@gmail.com>
Date: Mon, 24 Nov 2025 15:18:41 +0000
Subject: [PATCH] docs: add Ollama Cloud provider setup to providers.mdx

---
 packages/web/src/content/docs/providers.mdx | 48 +++++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/packages/web/src/content/docs/providers.mdx b/packages/web/src/content/docs/providers.mdx
index ec468205a90..01395656933 100644
--- a/packages/web/src/content/docs/providers.mdx
+++ b/packages/web/src/content/docs/providers.mdx
@@ -762,6 +762,54 @@ If tool calls aren't working, try increasing `num_ctx` in Ollama. Start around 1
 
 ---
 
+### Ollama Cloud
+
+To use Ollama Cloud with OpenCode:
+
+1. Head over to [https://ollama.com/](https://ollama.com/) and sign in or create an account.
+
+2. Navigate to **Settings** > **Keys** and click **Add API Key** to generate a new API key.
+
+3. Copy the API key for use in OpenCode.
+
+4. Run `opencode auth login` and select **Ollama Cloud**.
+
+   ```bash
+   $ opencode auth login
+
+   ┌  Add credential
+   │
+   ◆  Select provider
+   │  ● Ollama Cloud
+   │  ...
+   └
+   ```
+
+5. Enter your Ollama Cloud API key.
+
+   ```bash
+   $ opencode auth login
+
+   ┌  Add credential
+   │
+   ◇  Select provider
+   │  Ollama Cloud
+   │
+   ◇  Enter your API key
+   │  _
+   └
+   ```
+
+6. **Important**: Before using cloud models in OpenCode, you must pull the model information locally:
+
+   ```bash
+   ollama pull gpt-oss:20b-cloud
+   ```
+
+7. Run the `/models` command to select your Ollama Cloud model.
+
+---
+
 ### OpenAI
 
 1. Head over to the [OpenAI Platform console](https://platform.openai.com/api-keys), click **Create new secret key**, and copy the key.