# Hermes Terminal Backend

> The place where Hermes runs the commands it types.

**Field:** Artificial Intelligence  
**Category:** Hermes Agent  
**Also known as:** terminal.backend, Hermes Docker sandbox

## Think of it like

It is like choosing which room a messy craft gets done in.

## Definition

The terminal backend is where Hermes Agent runs the shell commands it types. The default is local, on your own machine. You can also pick docker for a container, or ssh for a server far away. Cloud sandboxes such as modal and daytona work too, and plugins add more. You set it in config.yaml.

## Example

Leo lets Hermes run code from strangers' bug reports. He sets the backend to docker, so nothing it runs can touch his files.

## Example code

```console
hermes config set terminal.backend docker
```

Run the agent's commands in a container.

## Why it matters

An agent that runs commands on your own machine can break it. A sandbox keeps the damage inside.

## Common mistake

Leaving it on local for a public chat bot. Anyone who can talk to it runs commands on your machine.

## Three principles

- **local by default.** Your machine.
- **docker or ssh.** Kept apart.
- **Cloud sandboxes.** modal, daytona.

## Related terms

- [Hermes Toolset](https://learn.benibix.com/term/ai/hermes-toolset)
- [Agent Sandbox](https://learn.benibix.com/term/ai/agent-sandbox)
- [Claude Code Sandbox](https://learn.benibix.com/term/ai/claude-code-sandbox)
- [Hermes Command Approval](https://learn.benibix.com/term/ai/hermes-command-approval)

## Told apart from

- [Hermes Command Approval vs Terminal Backend](https://learn.benibix.com/compare/hermes-command-approval-vs-hermes-terminal-backend): People think command approval keeps Hermes in a sandbox. It does not. Approval checks a risky command before it runs and may ask you first. The terminal backend decides where every command runs: your own machine, a container or a server far away. Approval can let a bad command through. A sandbox keeps the harm away from your files.

![Where Hermes runs its commands: on your own machine by default, or in a Docker container, on a server over SSH, or in a cloud sandbox.](https://learn.benibix.com/diagrams/hermes-terminal-backends.svg)

---

Source: https://learn.benibix.com/term/ai/hermes-terminal-backend
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
