From 0f3482cca10945880d8c9040042209c2b063e362 Mon Sep 17 00:00:00 2001 From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com> Date: Mon, 16 Nov 2026 15:45:03 +0000 Subject: [PATCH 1/3] Update stacklok/toolhive to v0.66.0 Signed-off-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com> --- .github/upstream-projects.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/upstream-projects.yaml b/.github/upstream-projects.yaml index fc2f796a6..8d770730e 100644 --- a/.github/upstream-projects.yaml +++ b/.github/upstream-projects.yaml @@ -64,7 +64,7 @@ projects: - id: toolhive repo: stacklok/toolhive - version: v0.65.0 + version: v0.66.0 # toolhive is a monorepo covering the CLI, the Kubernetes # operator, and the vMCP gateway. It also introduces cross- # cutting features that land in concepts/, integrations/, From 472f72d4e407711327385ca6c194427c40fd899a Mon Sep 17 00:00:00 2001 From: "stacklok-octosts[bot]" <327033170+stacklok-octosts[bot]@users.noreply.github.com> Date: Mon, 16 Nov 2026 15:47:54 +0000 Subject: [PATCH 2/3] Refresh reference assets for toolhive v0.66.0 --- docs/toolhive/reference/cli/thv_run.md | 1 + .../toolhive/reference/helm/operator-crds.mdx | 6 ++--- docs/toolhive/reference/helm/operator.mdx | 24 ++++++++++--------- static/api-specs/toolhive-api.yaml | 17 +++++++++++++ 4 files changed, 34 insertions(+), 14 deletions(-) diff --git a/docs/toolhive/reference/cli/thv_run.md b/docs/toolhive/reference/cli/thv_run.md index 774dc1185..61bd5319f 100644 --- a/docs/toolhive/reference/cli/thv_run.md +++ b/docs/toolhive/reference/cli/thv_run.md @@ -162,6 +162,7 @@ thv run [flags] SERVER_OR_IMAGE_OR_PROTOCOL [-- ARGS...] --proxy-port int Port for the HTTP proxy to listen on (host port) --proxy-read-timeout duration Maximum time to read a full request on the proxy (e.g., 30s, 1m); zero uses the default (30s) -p, --publish stringArray Publish a container's port(s) to the host (format: hostPort:containerPort) + --read-only-rootfs[=true|false] Mount the MCP server container's root filesystem as read-only (Docker/Podman only). /tmp, /var/tmp and /run get a 64 MiB noexec tmpfs unless a volume already targets them; servers that write anywhere else outside their mounted volumes will fail. --remote-auth[=true|false] Enable OAuth/OIDC authentication to remote MCP server (default false) --remote-auth-authorize-url string OAuth authorization endpoint URL (alternative to --remote-auth-issuer for non-OIDC OAuth) --remote-auth-bearer-token string Bearer token for remote server authentication (alternative to OAuth) diff --git a/docs/toolhive/reference/helm/operator-crds.mdx b/docs/toolhive/reference/helm/operator-crds.mdx index f318e2650..0bf680108 100644 --- a/docs/toolhive/reference/helm/operator-crds.mdx +++ b/docs/toolhive/reference/helm/operator-crds.mdx @@ -11,9 +11,9 @@ Control CRD installation and preservation with these Helm values. This reference lists values declared in the chart's default `values.yaml`. Templates can also accept optional settings and inherited `global` values. -Chart: `toolhive-operator-crds`. Chart version: `0.65.0`. Source: -[`values.yaml`](https://github.com/stacklok/toolhive/blob/v0.65.0/deploy/charts/operator-crds/values.yaml) -at `v0.65.0`. +Chart: `toolhive-operator-crds`. Chart version: `0.66.0`. Source: +[`values.yaml`](https://github.com/stacklok/toolhive/blob/v0.66.0/deploy/charts/operator-crds/values.yaml) +at `v0.66.0`. ## Values diff --git a/docs/toolhive/reference/helm/operator.mdx b/docs/toolhive/reference/helm/operator.mdx index c413cf39a..b53daa705 100644 --- a/docs/toolhive/reference/helm/operator.mdx +++ b/docs/toolhive/reference/helm/operator.mdx @@ -10,9 +10,9 @@ Configure the ToolHive operator with these Helm values. This reference lists values declared in the chart's default `values.yaml`. Templates can also accept optional settings and inherited `global` values. -Chart: `toolhive-operator`. Chart version: `0.65.0`. Source: -[`values.yaml`](https://github.com/stacklok/toolhive/blob/v0.65.0/deploy/charts/operator/values.yaml) -at `v0.65.0`. +Chart: `toolhive-operator`. Chart version: `0.66.0`. Source: +[`values.yaml`](https://github.com/stacklok/toolhive/blob/v0.66.0/deploy/charts/operator/values.yaml) +at `v0.66.0`. ## Values @@ -73,7 +73,7 @@ features: gc: gogc: 75 gomemlimit: 110MiB -image: ghcr.io/stacklok/toolhive/operator:v0.65.0 +image: ghcr.io/stacklok/toolhive/operator:v0.66.0 imageDiscovery: enabled: false resources: {} @@ -158,8 +158,8 @@ serviceAccount: labels: {} name: toolhive-operator tolerations: [] -toolhiveRunnerImage: ghcr.io/stacklok/toolhive/proxyrunner:v0.65.0 -vmcpImage: ghcr.io/stacklok/toolhive/vmcp:v0.65.0 +toolhiveRunnerImage: ghcr.io/stacklok/toolhive/proxyrunner:v0.66.0 +vmcpImage: ghcr.io/stacklok/toolhive/vmcp:v0.66.0 volumeMounts: [] volumes: [] ``` @@ -318,7 +318,7 @@ Key containing the PEM-encoded CA certificate in the Secret. **Type:** `string` -**Default:** `"ghcr.io/stacklok/toolhive/operator:v0.65.0"` +**Default:** `"ghcr.io/stacklok/toolhive/operator:v0.66.0"` Container image for the operator. @@ -334,7 +334,7 @@ Image pull policy for the operator container and image-discovery containers. **Type:** `string` -**Default:** `"ghcr.io/stacklok/toolhive/proxyrunner:v0.65.0"` +**Default:** `"ghcr.io/stacklok/toolhive/proxyrunner:v0.66.0"` Container image for ToolHive proxy runners created by the operator. @@ -342,7 +342,7 @@ Container image for ToolHive proxy runners created by the operator. **Type:** `string` -**Default:** `"ghcr.io/stacklok/toolhive/vmcp:v0.65.0"` +**Default:** `"ghcr.io/stacklok/toolhive/vmcp:v0.66.0"` Container image for Virtual MCP Server (vMCP) deployments created by the operator. @@ -393,8 +393,10 @@ workloads. Additional environment variables for the operator container. Chart-managed variables take precedence for duplicate names. Set `TOOLHIVE_SKIP_UPDATE_CHECK` -to `"true"` to disable periodic update checks and the usage metrics collected -with them. +to `"true"` to disable update checks and anonymous usage metrics, or +`TOOLHIVE_USAGE_METRICS_ENABLED` to `"false"` to disable usage metrics only. The +operator passes either setting to every MCPServer, MCPRemoteProxy and +VirtualMCPServer it deploys; changing it rolls out those workloads once. ### `operator.ports` diff --git a/static/api-specs/toolhive-api.yaml b/static/api-specs/toolhive-api.yaml index 78afd26de..d6c484270 100644 --- a/static/api-specs/toolhive-api.yaml +++ b/static/api-specs/toolhive-api.yaml @@ -2260,6 +2260,13 @@ components: description: RateLimitNamespace is the Kubernetes namespace for Redis key derivation. type: string + read_only_rootfs: + description: |- + ReadOnlyRootfs mounts the MCP server container's root filesystem as read-only. + /tmp, /var/tmp and /run get a small noexec tmpfs unless a volume targets them. + Opt-in: servers that write anywhere else outside their mounted volumes will fail. + Only applicable to Docker/Podman deployments. + type: boolean registry_api_url: description: |- RegistryAPIURL is the registry API URL that served this server's metadata. @@ -3529,6 +3536,11 @@ components: Empty or zero uses the default timeout of 30 seconds. example: 30s type: string + read_only_rootfs: + description: |- + Whether to mount the container's root filesystem as read-only. + Only applicable to Docker/Podman deployments. + type: boolean registry: description: Registry is the optional registry name to resolve the server from (e.g. "default"). @@ -4303,6 +4315,11 @@ components: Empty or zero uses the default timeout of 30 seconds. example: 30s type: string + read_only_rootfs: + description: |- + Whether to mount the container's root filesystem as read-only. + Only applicable to Docker/Podman deployments. + type: boolean runtime_config: $ref: '#/components/schemas/templates.RuntimeConfig' secrets: From dc952d30b09df35b5a252024e5ebdc345b0175a7 Mon Sep 17 00:00:00 2001 From: "stacklok-octosts[bot]" <327033170+stacklok-octosts[bot]@users.noreply.github.com> Date: Mon, 16 Nov 2026 15:53:38 +0000 Subject: [PATCH 3/3] Apply prettier and eslint fixups to skill output --- .../toolhive/guides-cli/filesystem-access.mdx | 28 +++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/docs/toolhive/guides-cli/filesystem-access.mdx b/docs/toolhive/guides-cli/filesystem-access.mdx index 4f91a401b..58d8dfe62 100644 --- a/docs/toolhive/guides-cli/filesystem-access.mdx +++ b/docs/toolhive/guides-cli/filesystem-access.mdx @@ -139,6 +139,34 @@ thv run --permission-profile ./file-permissions.json For more details on permission profiles and network permissions, see [custom permissions](./custom-permissions.mdx). +## Make the container's root file system read-only + +By default, an MCP server can write anywhere inside its own container, including +its image's files. To stop a compromised or misbehaving server from modifying +its own image layer, add the `--read-only-rootfs` flag: + +```bash +thv run --read-only-rootfs fetch +``` + +With this flag, ToolHive mounts the container's root file system as read-only. +The server can still write to: + +- The volumes you mount with `--volume` (unless you add `:ro`) and the `write` + paths in its permission profile. +- `/tmp`, `/var/tmp`, and `/run`, which each get a 64 MiB scratch space in + memory (a tmpfs). Files written there can't be executed and don't persist when + the container stops. If a volume already targets one of these paths, ToolHive + uses the volume instead. + +A server that writes anywhere else fails with a read-only file system error. To +fix this, mount a writable volume at the path the server needs, or run it +without the flag. + +The flag applies to Docker and Podman. In Kubernetes, the operator runs MCP +server containers with a read-only root file system by default; see +[Mount a volume](../guides-k8s/run-mcp-k8s.mdx#mount-a-volume). + ## Examples These examples use the Filesystem and Memory MCP servers from the ToolHive