Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.openhands.dev/llms.txt

Use this file to discover all available pages before exploring further.

The Process sandbox runs the agent server directly on your machine as a regular process.
This mode provides no sandbox isolation.The agent can read/write files your user account can access and execute commands on your host system.Only use this in controlled environments.

​
When to use it

  • Local development when Docker is unavailable
  • Some CI environments
  • Debugging issues that only reproduce outside containers

​
Choosing process mode

In some deployments, this is selected via the legacy RUNTIME environment variable: 
export RUNTIME=process
# (legacy alias)
# export RUNTIME=local
If you are unsure, prefer the Docker Sandbox.