\.ollama\id_ed25519.pub` |
-
-
- Replace <username> with your actual Windows user name.
-
-
## How can I stop Ollama from starting when I login to my computer?
Ollama for Windows and macOS register as a login item during installation. You can disable this if you prefer not to have Ollama automatically start. Ollama will respect this setting across upgrades, unless you uninstall the application.
diff --git a/docs/gpu.mdx b/docs/gpu.mdx
index e0e141442..97ecf3f66 100644
--- a/docs/gpu.mdx
+++ b/docs/gpu.mdx
@@ -35,7 +35,7 @@ Check your compute compatibility to see if your card is supported:
| 5.0 | GeForce GTX | `GTX 750 Ti` `GTX 750` `NVS 810` |
| | Quadro | `K2200` `K1200` `K620` `M1200` `M520` `M5000M` `M4000M` `M3000M` `M2000M` `M1000M` `K620M` `M600M` `M500M` |
-For building locally to support older GPUs, see [development](./development.md).
+For building locally to support older GPUs, see [development](/development).
### GPU Selection
diff --git a/docs/index.mdx b/docs/index.mdx
index 211d051c6..c631bcfe1 100644
--- a/docs/index.mdx
+++ b/docs/index.mdx
@@ -1,6 +1,7 @@
---
title: Ollama documentation
sidebarTitle: Welcome
+description: Learn what Ollama can do, choose cloud or local models, and find the right guide, integration, or API reference.
---
Use open models in your desktop apps and coding agents, or build them into your application.
@@ -14,27 +15,66 @@ Use open models in your desktop apps and coding agents, or build them into your
-## Explore models
+## Choose where models run
-Choose cloud models or run models on your computer.
+Cloud and local models use the same Ollama tools and API shapes. The main difference is where inference runs.
-
- Run models without a local GPU.
+
+ Run larger models without managing local compute, either from Ollama or through the Cloud API.
-
- Download Ollama and run a model on your computer.
+
+
+ Install Ollama and run models on macOS, Windows, Linux, or Docker.
Browse the [model library](https://ollama.com/search) for coding, vision, embeddings, and reasoning models.
+## What you can build
+
+Ollama supports [streaming](/capabilities/streaming), [tool calling](/capabilities/tool-calling), [structured outputs](/capabilities/structured-outputs), [decision models](/capabilities/decision), [vision](/capabilities/vision), [embeddings](/capabilities/embeddings), [thinking](/capabilities/thinking), and [web search](/capabilities/web-search).
+
## Documentation
-- [Integrations](/integrations) — connect an app, editor, or agent.
-- [API reference](/api/introduction) — use Ollama's API or compatible OpenAI and Anthropic clients.
-- [Python library](https://github.com/ollama/ollama-python) and [JavaScript library](https://github.com/ollama/ollama-js) — use Ollama from your application.
+
+
+ Connect Ollama to an app, editor, or agent.
+
+
+
+ Compare local and cloud base URLs, then send your first request.
+
+
+
+ Find models for chat, coding, vision, embeddings, and reasoning.
+
+
+
+ Use Ollama from Python.
+
+
+
+ Use Ollama from JavaScript or TypeScript.
+
+
## Community
-Join the conversation on [Discord](https://discord.gg/ollama) or [Reddit](https://reddit.com/r/ollama).
+
+
+ Join the Ollama Discord.
+
+
+
+ Join the Ollama subreddit.
+
+
+
+ Follow Ollama on X.
+
+
+
+ Explore Ollama on GitHub.
+
+
diff --git a/docs/integrations/claude-code.mdx b/docs/integrations/claude-code.mdx
index b27b8834f..93d234871 100644
--- a/docs/integrations/claude-code.mdx
+++ b/docs/integrations/claude-code.mdx
@@ -155,7 +155,7 @@ Claude Code prompts for permission on most actions. To allow the bot to work aut
See the [plugin README](https://github.com/anthropics/claude-plugins-official/tree/main/external_plugins/telegram) for setup instructions.
-## Connect directly to Ollama Cloud
+## Connect directly to Ollama's cloud
Install Claude Code, then set your [API key](/quickstart#build-an-application) in `OLLAMA_API_KEY`. No Ollama installation required.
diff --git a/docs/integrations/claude-desktop.mdx b/docs/integrations/claude-desktop.mdx
index 3bfa3b176..258ad5f13 100644
--- a/docs/integrations/claude-desktop.mdx
+++ b/docs/integrations/claude-desktop.mdx
@@ -26,7 +26,7 @@ Open Ollama **Settings → Apps**. Choose your models, then select **Restart Cla
- **Subagents** - Split larger tasks across agents
- **Web search** - Supported by default through [Ollama's web search](/capabilities/web-search)
-- **Cowork** - Complete difficult tasks with Claude Cowork
+- **Cowork** - Complete difficult tasks with Claude Cowork
- **Auto mode** - Let the agent decide when to ask before making changes
## Disconnect Claude
diff --git a/docs/integrations/deepseek-harness.mdx b/docs/integrations/deepseek-harness.mdx
index c09ff9817..1f659654f 100644
--- a/docs/integrations/deepseek-harness.mdx
+++ b/docs/integrations/deepseek-harness.mdx
@@ -27,7 +27,7 @@ ollama launch dsh --config
## Web search
-Web search is enabled automatically. It requires Ollama cloud access and a model that supports tools. Run `ollama signin` if needed.
+Web search is enabled automatically. It requires access to Ollama's cloud and a model that supports tools. Run `ollama signin` if needed.
## Configuration
diff --git a/docs/integrations/droid.mdx b/docs/integrations/droid.mdx
index 249554510..7ea182d46 100644
--- a/docs/integrations/droid.mdx
+++ b/docs/integrations/droid.mdx
@@ -56,7 +56,7 @@ Add the cloud configuration block to `~/.factory/config.json`:
{
"custom_models": [
{
- "model_display_name": "qwen3-coder [Ollama Cloud]",
+ "model_display_name": "qwen3-coder [Ollama's cloud]",
"model": "qwen3-coder:480b-cloud",
"base_url": "http://localhost:11434/v1/",
"api_key": "not-needed",
@@ -76,7 +76,7 @@ Add the cloud configuration block to `~/.factory/config.json`:
{
"custom_models": [
{
- "model_display_name": "qwen3-coder [Ollama Cloud]",
+ "model_display_name": "qwen3-coder [Ollama's cloud]",
"model": "qwen3-coder:480b",
"base_url": "https://ollama.com/v1/",
"api_key": "OLLAMA_API_KEY",
diff --git a/docs/integrations/marimo.mdx b/docs/integrations/marimo.mdx
index 33815891b..73516cb47 100644
--- a/docs/integrations/marimo.mdx
+++ b/docs/integrations/marimo.mdx
@@ -68,6 +68,6 @@ would typically point the base url to `http://localhost:11434/v1`.
## Connecting to ollama.com
-1. Sign in to ollama cloud via `ollama signin`
+1. Sign in to Ollama's cloud with `ollama signin`
2. In the ollama model settings add a model that ollama hosts, like `gpt-oss:120b`.
3. You can now refer to this model in marimo!
diff --git a/docs/integrations/onyx.mdx b/docs/integrations/onyx.mdx
index e0587efb2..b5235ed37 100644
--- a/docs/integrations/onyx.mdx
+++ b/docs/integrations/onyx.mdx
@@ -51,7 +51,7 @@ Resourcing/scaling docs [here](https://docs.onyx.app/deployment/getting_started/
/>
-You can also easily connect up Onyx Cloud with the `Ollama Cloud` tab of the setup.
+You can also connect Onyx Cloud to Ollama's cloud from the setup flow.
## Send your first query
@@ -60,4 +60,4 @@ You can also easily connect up Onyx Cloud with the `Ollama Cloud` tab of the set
alt="Onyx Query Example"
width="75%"
/>
-
\ No newline at end of file
+
diff --git a/docs/local/index.mdx b/docs/local/index.mdx
new file mode 100644
index 000000000..38520aadd
--- /dev/null
+++ b/docs/local/index.mdx
@@ -0,0 +1,57 @@
+---
+title: Run Ollama locally
+sidebarTitle: Overview
+description: Install, configure, and run Ollama models on your own macOS, Windows, Linux, or Docker environment.
+---
+
+Run models on your own hardware with Ollama. Local inference keeps model execution on the machine or infrastructure you control and does not require an Ollama account.
+
+## Install Ollama
+
+Choose the installation guide for your environment.
+
+
+
+ Install the Ollama app on Apple silicon or Intel hardware.
+
+
+
+ Install the native Windows application.
+
+
+
+ Install Ollama with the install script or a manual package.
+
+
+
+ Run Ollama in a container with CPU or GPU acceleration.
+
+
+
+## Run a local model
+
+After installation, start a model from the terminal:
+
+```shell
+ollama run gemma4
+```
+
+Ollama also serves its local API at `http://localhost:11434/api` by default.
+
+```shell
+curl http://localhost:11434/api/chat -d '{
+ "model": "gemma4",
+ "messages": [{"role": "user", "content": "Why is the sky blue?"}],
+ "stream": false
+}'
+```
+
+## Configure your environment
+
+- Use the [CLI reference](/cli) to run, download, copy, and remove models.
+- Adjust the [context length](/context-length) for agents and other long-context workloads.
+- Review [hardware support](/gpu) for GPU compatibility and acceleration.
+- [Import a model](/import) or create a customized model with a [Modelfile](/modelfile).
+- Use [local-only mode](/faq#how-do-i-disable-ollama-cloud-features) to disable Ollama's cloud features.
+
+For failures, start with [Troubleshooting](/troubleshooting).
diff --git a/docs/openapi.yaml b/docs/openapi.yaml
index 6f2c2fe26..2a9ffe398 100644
--- a/docs/openapi.yaml
+++ b/docs/openapi.yaml
@@ -2116,7 +2116,7 @@ paths:
operationId: usage
servers:
- url: https://ollama.com
- description: Ollama Cloud
+ description: Ollama's cloud
security:
- bearerAuth: []
parameters:
@@ -2184,7 +2184,7 @@ paths:
operationId: balance
servers:
- url: https://ollama.com
- description: Ollama Cloud
+ description: Ollama's cloud
security:
- bearerAuth: []
responses:
diff --git a/docs/quickstart.mdx b/docs/quickstart.mdx
index 683251994..3297ce828 100644
--- a/docs/quickstart.mdx
+++ b/docs/quickstart.mdx
@@ -1,5 +1,6 @@
---
title: Quickstart
+description: Use Ollama with desktop apps, coding agents, cloud APIs, or models running on your computer.
---
Use Ollama in [desktop apps](#connect-a-desktop-app) and [coding agents](#use-a-coding-agent), or [build an application](#build-an-application) with an API key.