# Open Terminal

Open Terminal is a lightweight, self-hosted terminal that gives AI agents and automation tools a dedicated environment to run commands, manage files, and execute code all through a simple API. It is open source and self-hosted, installable on TrueNAS.

Canonical page: https://ourlocalhost.com/app/3752/open-terminal

## Description

Open Terminal is a lightweight, self-hosted terminal that gives AI agents and automation tools a dedicated environment to run commands, manage files, and execute code all through a simple API.

## Platform availability

Available on 1 of 10 platforms: TrueNAS.

## Health score

76/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 5 days ago)
- Popular: 71 (3,591 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)
- Security check: 85 (no serious findings, CI)

## Links

- Official website: https://openterminal.sh/
- TrueNAS: https://apps.truenas.com/catalog/open-terminal/
- GitHub: https://github.com/open-webui/open-terminal

## Common questions

### Which directory should I mount in Docker for Open Terminal files?

Map a Docker volume to /home/user, as in the documented open-terminal:/home/user mount.

### Why is Open Terminal unreachable even though the container is running?

You need to expose port 8000 with -p 8000:8000. Port 8000 is the address used by the browser, Open WebUI, or MCP client to reach the app.

### What happens if I don't set an API key for Docker?

A key is generated automatically. You can retrieve it with docker logs open-terminal.

### What should I back up so I don't have to recreate Open Terminal settings?

Back up the TOML config file, because it holds settings such as api_key, host, port, and log_dir. Losing it may require recreating your access key, storage paths, and server settings.

### Can I install additional packages at runtime in the slim or alpine images?

No; slim and alpine do not support OPEN_TERMINAL_PACKAGES, OPEN_TERMINAL_PIP_PACKAGES, or OPEN_TERMINAL_NPM_PACKAGES. To add packages, extend the Dockerfile for those variants.

---
Source: Our Local Host (https://ourlocalhost.com/app/3752/open-terminal), the self-hosted and open-source app directory.
