Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
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
15 changes: 12 additions & 3 deletions docs/toolhive/guides-cli/run-mcp-servers.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -527,9 +527,18 @@ For example, to run a server using the exported configuration:
thv run --from-config ./fetch-config.json
```

This creates a new server instance with identical settings to the original. If
the original server used secrets, you must have the same secrets available in
your ToolHive secrets store.
This creates a persistent server instance with identical settings to the original
and saves a real configuration file. The server can be stopped, restarted, and
managed like any other workload. If the original server used secrets, you must
have the same secrets available in your ToolHive secrets store.

:::note

When using `--from-config`, no other command-line flags can be used to avoid
unexpected behavior. All configuration must be specified in the configuration
file.

:::

## Next steps

Expand Down
3 changes: 2 additions & 1 deletion docs/toolhive/reference/cli/thv_export.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,8 @@ Export a workload's run configuration to a file
Export a workload's run configuration to a file for sharing or backup.

The exported configuration can be used with 'thv run --from-config <path>' to recreate
the same workload with identical settings.
the same workload with identical settings as a persistent server that can be
stopped, restarted, and managed like any other workload.

Examples:

Expand Down
3 changes: 3 additions & 0 deletions docs/toolhive/reference/cli/thv_run.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,6 +49,9 @@ ToolHive supports five ways to run an MCP server:
$ thv run --from-config <path>

Runs an MCP server using a previously exported configuration file.
This saves a real configuration file and creates a persistent workload that
can be stopped, restarted, and managed like any other server. Cannot
be used with other flags.

5. Remote MCP server:

Expand Down
Loading