From 152fcf19232e7f8a20f4b7835c9291548c33ffb0 Mon Sep 17 00:00:00 2001 From: Eleftheria Stein-Kousathana Date: Mon, 8 Sep 2025 12:04:40 +0200 Subject: [PATCH 1/2] Add Colima --- docs/toolhive/guides-cli/install.mdx | 1 + docs/toolhive/guides-cli/run-mcp-servers.mdx | 2 +- docs/toolhive/guides-ui/install.mdx | 3 ++- docs/toolhive/reference/cli/thv.md | 2 +- docs/toolhive/tutorials/quickstart-cli.mdx | 5 +++-- docs/toolhive/tutorials/quickstart-ui.mdx | 5 +++-- 6 files changed, 11 insertions(+), 7 deletions(-) diff --git a/docs/toolhive/guides-cli/install.mdx b/docs/toolhive/guides-cli/install.mdx index 63fe6e8d..61f18daf 100644 --- a/docs/toolhive/guides-cli/install.mdx +++ b/docs/toolhive/guides-cli/install.mdx @@ -17,6 +17,7 @@ Before installing ToolHive, make sure your system meets these requirements: - **Container runtime**: - Docker / Docker Desktop - Podman / Podman Desktop + - Colima with Docker runtime - Rancher Desktop with the dockerd/moby runtime (experimental) ToolHive requires minimal CPU, memory, and disk space. The exact requirements diff --git a/docs/toolhive/guides-cli/run-mcp-servers.mdx b/docs/toolhive/guides-cli/run-mcp-servers.mdx index f0b24304..73ddc8e6 100644 --- a/docs/toolhive/guides-cli/run-mcp-servers.mdx +++ b/docs/toolhive/guides-cli/run-mcp-servers.mdx @@ -552,7 +552,7 @@ control your servers. If a server fails to start: -1. Check if Docker/Podman is running +1. Check if Docker/Podman/Colima is running 2. Verify you have internet access to pull images 3. Check if the port is already in use 4. Look at the error message for specific issues diff --git a/docs/toolhive/guides-ui/install.mdx b/docs/toolhive/guides-ui/install.mdx index 1a244634..e9cb76d4 100644 --- a/docs/toolhive/guides-ui/install.mdx +++ b/docs/toolhive/guides-ui/install.mdx @@ -20,6 +20,7 @@ Before installing ToolHive, make sure your system meets these requirements: - **Container runtime**: - Docker / Docker Desktop - Podman / Podman Desktop + - Colima with Docker runtime - Rancher Desktop with the dockerd/moby runtime (experimental) ToolHive requires minimal CPU, memory, and disk space. The exact requirements @@ -217,7 +218,7 @@ MCP servers. See [Run MCP servers](./run-mcp-servers.md) to get started. Connection Refused error on startup If you see a "Connection Refused" error when starting ToolHive, your container -runtime (Docker or Podman) is likely not installed, not running, or not +runtime (Docker, Podman or Colima) is likely not installed, not running, or not configured correctly. Follow the instructions in the error message to install or start your container diff --git a/docs/toolhive/reference/cli/thv.md b/docs/toolhive/reference/cli/thv.md index 60b33bc2..63a7174d 100644 --- a/docs/toolhive/reference/cli/thv.md +++ b/docs/toolhive/reference/cli/thv.md @@ -18,7 +18,7 @@ ToolHive (thv) is a lightweight, secure, and fast manager for MCP servers ToolHive (thv) is a lightweight, secure, and fast manager for MCP (Model Context Protocol) servers. It is written in Go and has extensive test coverage—including input validation—to ensure reliability and security. -Under the hood, ToolHive acts as a very thin client for the Docker/Podman Unix socket API. +Under the hood, ToolHive acts as a very thin client for the Docker/Podman/Colima Unix socket API. This design choice allows it to remain both efficient and lightweight while still providing powerful, container-based isolation for running MCP servers. diff --git a/docs/toolhive/tutorials/quickstart-cli.mdx b/docs/toolhive/tutorials/quickstart-cli.mdx index a136d61d..6567fb32 100644 --- a/docs/toolhive/tutorials/quickstart-cli.mdx +++ b/docs/toolhive/tutorials/quickstart-cli.mdx @@ -23,7 +23,8 @@ or Cursor. Before starting this tutorial, make sure you have: - [Docker](https://docs.docker.com/get-docker/) or - [Podman](https://podman-desktop.io/downloads) installed and running + [Podman](https://podman-desktop.io/downloads) or + [Colima](https://github.com/abiosoft/colima) installed and running - A [supported MCP client](../reference/client-compatibility.mdx) like GitHub Copilot in VS Code, Cursor, Claude Code, and more @@ -305,7 +306,7 @@ server. Here are some next steps to explore: If the server fails to start, check: -- Is Docker or Podman running? +- Is Docker, Podman or Colima running? - Do you have internet access to pull the container image? - Is the port already in use by another application? diff --git a/docs/toolhive/tutorials/quickstart-ui.mdx b/docs/toolhive/tutorials/quickstart-ui.mdx index cda0e73d..8069a22f 100644 --- a/docs/toolhive/tutorials/quickstart-ui.mdx +++ b/docs/toolhive/tutorials/quickstart-ui.mdx @@ -22,7 +22,8 @@ Cursor. Before starting this tutorial, make sure you have: - [Docker](https://docs.docker.com/get-docker/) or - [Podman](https://podman-desktop.io/downloads) installed and running + [Podman](https://podman-desktop.io/downloads) or + [Colima](https://github.com/abiosoft/colima) installed and running - A [supported MCP client](../reference/client-compatibility.mdx) like GitHub Copilot in VS Code, Cursor, Claude Code, and more @@ -139,7 +140,7 @@ server. Here are some next steps to explore: If the server fails to start, check: -- Is Docker or Podman running? +- Is Docker, Podman or Colima running? - Do you have internet access to pull the container image? From 11c1cdeb394c66d58feb3363fb6ba9de0f889db8 Mon Sep 17 00:00:00 2001 From: Eleftheria Stein-Kousathana Date: Mon, 8 Sep 2025 12:09:27 +0200 Subject: [PATCH 2/2] Oxford commas --- docs/toolhive/guides-cli/run-mcp-servers.mdx | 2 +- docs/toolhive/guides-ui/install.mdx | 2 +- docs/toolhive/tutorials/quickstart-cli.mdx | 2 +- docs/toolhive/tutorials/quickstart-ui.mdx | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/toolhive/guides-cli/run-mcp-servers.mdx b/docs/toolhive/guides-cli/run-mcp-servers.mdx index 73ddc8e6..2d055d35 100644 --- a/docs/toolhive/guides-cli/run-mcp-servers.mdx +++ b/docs/toolhive/guides-cli/run-mcp-servers.mdx @@ -552,7 +552,7 @@ control your servers. If a server fails to start: -1. Check if Docker/Podman/Colima is running +1. Check if Docker, Podman, or Colima is running 2. Verify you have internet access to pull images 3. Check if the port is already in use 4. Look at the error message for specific issues diff --git a/docs/toolhive/guides-ui/install.mdx b/docs/toolhive/guides-ui/install.mdx index e9cb76d4..b96ceb60 100644 --- a/docs/toolhive/guides-ui/install.mdx +++ b/docs/toolhive/guides-ui/install.mdx @@ -218,7 +218,7 @@ MCP servers. See [Run MCP servers](./run-mcp-servers.md) to get started. Connection Refused error on startup If you see a "Connection Refused" error when starting ToolHive, your container -runtime (Docker, Podman or Colima) is likely not installed, not running, or not +runtime (Docker, Podman, or Colima) is likely not installed, not running, or not configured correctly. Follow the instructions in the error message to install or start your container diff --git a/docs/toolhive/tutorials/quickstart-cli.mdx b/docs/toolhive/tutorials/quickstart-cli.mdx index 6567fb32..77677d78 100644 --- a/docs/toolhive/tutorials/quickstart-cli.mdx +++ b/docs/toolhive/tutorials/quickstart-cli.mdx @@ -306,7 +306,7 @@ server. Here are some next steps to explore: If the server fails to start, check: -- Is Docker, Podman or Colima running? +- Is Docker, Podman, or Colima running? - Do you have internet access to pull the container image? - Is the port already in use by another application? diff --git a/docs/toolhive/tutorials/quickstart-ui.mdx b/docs/toolhive/tutorials/quickstart-ui.mdx index 8069a22f..884a1863 100644 --- a/docs/toolhive/tutorials/quickstart-ui.mdx +++ b/docs/toolhive/tutorials/quickstart-ui.mdx @@ -140,7 +140,7 @@ server. Here are some next steps to explore: If the server fails to start, check: -- Is Docker, Podman or Colima running? +- Is Docker, Podman, or Colima running? - Do you have internet access to pull the container image?