Skip to content

Document volume mounts using the UI #113

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Aug 14, 2025
Merged

Document volume mounts using the UI #113

Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
29eb67a
Document volume mounts using the UI
kantord Aug 13, 2025
9e98e75
Merge branch 'main' into document-ui-mounts
kantord Aug 14, 2025
cc10b42
mention volume mounts in each section
kantord Aug 14, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions docs/toolhive/guides-ui/run-mcp-servers.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -200,6 +200,24 @@ On the configuration form, enter:

Click **Install server** to create and start the MCP server container.

## Mount host files and folders (Volumes)

Some MCP servers need access to files on your machine. You can mount host paths
directly in the UI.

1. In the server **Install / Configure** dialog, scroll to **Storage volumes**.
2. Use the **first row** to create your mount:
- **Host path** — choose a file or folder on your computer.
- **Container path** — where it should appear inside the server (for example,
`/data`).
- (Optional) uncheck **Read-only** to allow the server to write. By default,
mounts are read-only.
3. If you need additional mounts, click **Add a volume** and repeat.
4. Click **Install server** to start the server with your volume(s).

This applies to both registry-installed servers and custom servers (Docker image
or source package).

## Manage MCP servers

On the **MCP Servers** page, you can manage your installed MCP servers:
Expand Down