From 21a2d2b423b0151e1b5ef2d920c937d76b2d65aa Mon Sep 17 00:00:00 2001
From: enyst <engel.nyst@gmail.com>
Date: Mon, 26 Jan 2026 10:31:37 +0000
Subject: [PATCH 01/10] docs: add Web_V0 tab and V1 sandbox docs

Co-authored-by: openhands <openhands@all-hands.dev>
---
 .github/CODEOWNERS                            |   2 +-
 docs.json                                     |  94 +++-
 openapi/{openapi.json => V0_openapi.json}     |   0
 .../usage/advanced/configuration-options.mdx  | 452 ++----------------
 openhands/usage/api/v1.mdx                    |  42 ++
 openhands/usage/cli/gui-server.mdx            |   2 +-
 openhands/usage/cli/installation.mdx          |   2 +-
 openhands/usage/llms/openhands-llms.mdx       |  11 +-
 openhands/usage/run-openhands/local-setup.mdx |   2 +-
 openhands/usage/runtimes/overview.mdx         |  40 --
 openhands/usage/sandboxes/docker.mdx          |  46 ++
 openhands/usage/sandboxes/overview.mdx        |  30 ++
 openhands/usage/sandboxes/process.mdx         |  30 ++
 openhands/usage/sandboxes/remote.mdx          |  18 +
 .../v0/advanced/V0_configuration-options.mdx  | 446 +++++++++++++++++
 .../runtimes/V0_daytona.mdx}                  |   7 +-
 .../docker.mdx => v0/runtimes/V0_docker.mdx}  |   7 +-
 .../e2b.mdx => v0/runtimes/V0_e2b.mdx}        |   7 +-
 .../local.mdx => v0/runtimes/V0_local.mdx}    |   7 +-
 .../modal.mdx => v0/runtimes/V0_modal.mdx}    |   7 +-
 openhands/usage/v0/runtimes/V0_overview.mdx   |  45 ++
 .../remote.mdx => v0/runtimes/V0_remote.mdx}  |   7 +-
 .../runtimes/V0_runloop.mdx}                  |   7 +-
 23 files changed, 818 insertions(+), 493 deletions(-)
 rename openapi/{openapi.json => V0_openapi.json} (100%)
 create mode 100644 openhands/usage/api/v1.mdx
 delete mode 100644 openhands/usage/runtimes/overview.mdx
 create mode 100644 openhands/usage/sandboxes/docker.mdx
 create mode 100644 openhands/usage/sandboxes/overview.mdx
 create mode 100644 openhands/usage/sandboxes/process.mdx
 create mode 100644 openhands/usage/sandboxes/remote.mdx
 create mode 100644 openhands/usage/v0/advanced/V0_configuration-options.mdx
 rename openhands/usage/{runtimes/daytona.mdx => v0/runtimes/V0_daytona.mdx} (88%)
 rename openhands/usage/{runtimes/docker.mdx => v0/runtimes/V0_docker.mdx} (96%)
 rename openhands/usage/{runtimes/e2b.mdx => v0/runtimes/V0_e2b.mdx} (86%)
 rename openhands/usage/{runtimes/local.mdx => v0/runtimes/V0_local.mdx} (93%)
 rename openhands/usage/{runtimes/modal.mdx => v0/runtimes/V0_modal.mdx} (68%)
 create mode 100644 openhands/usage/v0/runtimes/V0_overview.mdx
 rename openhands/usage/{runtimes/remote.mdx => v0/runtimes/V0_remote.mdx} (75%)
 rename openhands/usage/{runtimes/runloop.mdx => v0/runtimes/V0_runloop.mdx} (82%)

diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS
index 73bd45874..5cd186cca 100644
--- a/.github/CODEOWNERS
+++ b/.github/CODEOWNERS
@@ -1,5 +1,5 @@
 /openhands/ @mamoodi
-/openapi/openapi.json @tofarr
+/openapi/V0_openapi.json @tofarr
 /openapi/agent-sdk.json @xingyaoww @enyst
 /sdk/ @xingyaoww @enyst
 /success-stories/ @jamiechicago312
\ No newline at end of file
diff --git a/docs.json b/docs.json
index 3738b7679..4d1cb34c9 100644
--- a/docs.json
+++ b/docs.json
@@ -105,7 +105,9 @@
           },
           {
             "group": "REST API",
-            "openapi": "openapi/openapi.json"
+            "pages": [
+              "openhands/usage/api/v1"
+            ]
           },
           {
             "group": "Customizations & Settings",
@@ -148,24 +150,15 @@
                 ]
               },
               {
-                "group": "Runtime Configuration",
+                "group": "Sandbox Configuration",
                 "pages": [
-                  "openhands/usage/runtimes/overview",
+                  "openhands/usage/sandboxes/overview",
                   {
                     "group": "Providers",
                     "pages": [
-                      "openhands/usage/runtimes/docker",
-                      "openhands/usage/runtimes/remote",
-                      "openhands/usage/runtimes/local",
-                      {
-                        "group": "Third-Party Providers",
-                        "pages": [
-                          "openhands/usage/runtimes/modal",
-                          "openhands/usage/runtimes/daytona",
-                          "openhands/usage/runtimes/runloop",
-                          "openhands/usage/runtimes/e2b"
-                        ]
-                      }
+                      "openhands/usage/sandboxes/docker",
+                      "openhands/usage/sandboxes/remote",
+                      "openhands/usage/sandboxes/process"
                     ]
                   }
                 ]
@@ -177,6 +170,44 @@
           }
         ]
       },
+      {
+        "tab": "Web_V0",
+        "pages": [
+          {
+            "group": "V0 REST API",
+            "openapi": "openapi/V0_openapi.json"
+          },
+          {
+            "group": "V0 Runtime Configuration",
+            "pages": [
+              "openhands/usage/v0/runtimes/V0_overview",
+              {
+                "group": "Providers",
+                "pages": [
+                  "openhands/usage/v0/runtimes/V0_docker",
+                  "openhands/usage/v0/runtimes/V0_remote",
+                  "openhands/usage/v0/runtimes/V0_local",
+                  {
+                    "group": "Third-Party Providers",
+                    "pages": [
+                      "openhands/usage/v0/runtimes/V0_modal",
+                      "openhands/usage/v0/runtimes/V0_daytona",
+                      "openhands/usage/v0/runtimes/V0_runloop",
+                      "openhands/usage/v0/runtimes/V0_e2b"
+                    ]
+                  }
+                ]
+              }
+            ]
+          },
+          {
+            "group": "V0 Configuration Options",
+            "pages": [
+              "openhands/usage/v0/advanced/V0_configuration-options"
+            ]
+          }
+        ]
+      },
       {
         "tab": "CLI",
         "pages": [
@@ -578,6 +609,39 @@
     {
       "source": "/openhands/usage/run-openhands/cli/resume",
       "destination": "/openhands/usage/cli/resume"
+    },
+    {
+      "source": "/openhands/usage/runtimes/overview",
+      "destination": "/openhands/usage/sandboxes/overview"
+    },
+    {
+      "source": "/openhands/usage/runtimes/docker",
+      "destination": "/openhands/usage/sandboxes/docker"
+    },
+    {
+      "source": "/openhands/usage/runtimes/remote",
+      "destination": "/openhands/usage/sandboxes/remote"
+    },
+    {
+      "source": "/openhands/usage/runtimes/local",
+      "destination": "/openhands/usage/sandboxes/process"
+    },
+    {
+      "source": "/openhands/usage/runtimes/e2b",
+      "destination": "/openhands/usage/v0/runtimes/V0_e2b"
+    },
+    {
+      "source": "/openhands/usage/runtimes/modal",
+      "destination": "/openhands/usage/v0/runtimes/V0_modal"
+    },
+    {
+      "source": "/openhands/usage/runtimes/runloop",
+      "destination": "/openhands/usage/v0/runtimes/V0_runloop"
+    },
+    {
+      "source": "/openhands/usage/runtimes/daytona",
+      "destination": "/openhands/usage/v0/runtimes/V0_daytona"
     }
+
   ]
 }
\ No newline at end of file
diff --git a/openapi/openapi.json b/openapi/V0_openapi.json
similarity index 100%
rename from openapi/openapi.json
rename to openapi/V0_openapi.json
diff --git a/openhands/usage/advanced/configuration-options.mdx b/openhands/usage/advanced/configuration-options.mdx
index 13f3523b0..c5179f21d 100644
--- a/openhands/usage/advanced/configuration-options.mdx
+++ b/openhands/usage/advanced/configuration-options.mdx
@@ -1,441 +1,51 @@
 ---
 title: Configuration Options
-description: This page outlines all available configuration options for OpenHands, allowing you to customize its
-  behavior and integrate it with other services.
+description: How to configure OpenHands V1 (Web UI, env vars, and sandbox settings).
 ---
 
 <Note>
-  These settings are only available in [Local GUI](/openhands/usage/run-openhands/local-setup). OpenHands Cloud uses a web-based settings interface.
-</Note>
-
-<Note>
-   In GUI Mode, any settings applied through the Settings UI will take precedence.
-</Note>
-
-<Note>
-   **Looking for Environment Variables?** All configuration options can also be set using environment variables. 
-   See the [Environment Variables Reference](/openhands/usage/environment-variables) for a complete list with examples.
-</Note>
-
-## Location of the `config.toml` File
-
-When running OpenHands in CLI, headless, or development mode, you can use a project-specific `config.toml` file for configuration, which must be
-located in the same directory from which the command is run. Alternatively, you may use the `--config-file` option to
-specify a different path to the `config.toml` file.
-
-## Core Configuration
-
-The core configuration options are defined in the `[core]` section of the `config.toml` file.
-
-Core configuration options can be set as environment variables by converting to uppercase. For example:
-- `debug` → `DEBUG`
-- `cache_dir` → `CACHE_DIR`
-- `runtime` → `RUNTIME`
-
-### Workspace
-- `workspace_base` **(Deprecated)**
-  - Type: `str`
-  - Default: `"./workspace"`
-  - Description: Base path for the workspace. **Deprecated: Use `SANDBOX_VOLUMES` instead.**
-
-- `cache_dir`
-  - Type: `str`
-  - Default: `"/tmp/cache"`
-  - Description: Cache directory path
-
-### Debugging and Logging
-- `debug`
-  - Type: `bool`
-  - Default: `false`
-  - Description: Enable debugging
-
-- `disable_color`
-  - Type: `bool`
-  - Default: `false`
-  - Description: Disable color in terminal output
-
-### Trajectories
-- `save_trajectory_path`
-  - Type: `str`
-  - Default: `"./trajectories"`
-  - Description: Path to store trajectories (can be a folder or a file). If it's a folder, the trajectories will be saved in a file named with the session id name and .json extension, in that folder.
-
-- `replay_trajectory_path`
-  - Type: `str`
-  - Default: `""`
-  - Description: Path to load a trajectory and replay. If given, must be a path to the trajectory file in JSON format. The actions in the trajectory file would be replayed first before any user instruction is executed.
-
-### File Store
-- `file_store_path`
-  - Type: `str`
-  - Default: `"/tmp/file_store"`
-  - Description: File store path
-
-- `file_store`
-  - Type: `str`
-  - Default: `"memory"`
-  - Description: File store type
-
-- `file_uploads_allowed_extensions`
-  - Type: `list of str`
-  - Default: `[".*"]`
-  - Description: List of allowed file extensions for uploads
-
-- `file_uploads_max_file_size_mb`
-  - Type: `int`
-  - Default: `0`
-  - Description: Maximum file size for uploads, in megabytes
+  This page documents the current <b>V1</b> configuration model.
 
-- `file_uploads_restrict_file_types`
-  - Type: `bool`
-  - Default: `false`
-  - Description: Restrict file types for file uploads
-
-- `file_uploads_allowed_extensions`
-  - Type: `list of str`
-  - Default: `[".*"]`
-  - Description: List of allowed file extensions for uploads
-
-### Task Management
-- `max_budget_per_task`
-  - Type: `float`
-  - Default: `0.0`
-  - Description: Maximum budget per task (0.0 means no limit)
-
-- `max_iterations`
-  - Type: `int`
-  - Default: `100`
-  - Description: Maximum number of iterations
-
-### Sandbox Configuration
-- `volumes`
-  - Type: `str`
-  - Default: `None`
-  - Description: Volume mounts in the format 'host_path:container_path[:mode]', e.g. '/my/host/dir:/workspace:rw'. Multiple mounts can be specified using commas, e.g. '/path1:/workspace/path1,/path2:/workspace/path2:ro'
-
-- `workspace_mount_path_in_sandbox` **(Deprecated)**
-  - Type: `str`
-  - Default: `"/workspace"`
-  - Description: Path to mount the workspace in the sandbox. **Deprecated: Use `SANDBOX_VOLUMES` instead.**
-
-- `workspace_mount_path` **(Deprecated)**
-  - Type: `str`
-  - Default: `""`
-  - Description: Path to mount the workspace. **Deprecated: Use `SANDBOX_VOLUMES` instead.**
-
-- `workspace_mount_rewrite` **(Deprecated)**
-  - Type: `str`
-  - Default: `""`
-  - Description: Path to rewrite the workspace mount path to. You can usually ignore this, it refers to special cases of running inside another container. **Deprecated: Use `SANDBOX_VOLUMES` instead.**
-
-### Miscellaneous
-- `run_as_openhands`
-  - Type: `bool`
-  - Default: `true`
-  - Description: Run as OpenHands
-
-- `runtime`
-  - Type: `str`
-  - Default: `"docker"`
-  - Description: Runtime environment
-
-- `default_agent`
-  - Type: `str`
-  - Default: `"CodeActAgent"`
-  - Description: Name of the default agent
-
-- `jwt_secret`
-  - Type: `str`
-  - Default: `uuid.uuid4().hex`
-  - Description: JWT secret for authentication. Please set it to your own value.
-
-## LLM Configuration
-
-The LLM (Large Language Model) configuration options are defined in the `[llm]` section of the `config.toml` file.
-
-To use these with the docker command, pass in `-e LLM_<option>`. Example: `-e LLM_NUM_RETRIES`.
-
-All LLM configuration options can be set as environment variables by prefixing with `LLM_` and converting to uppercase. For example:
-- `model` → `LLM_MODEL`
-- `api_key` → `LLM_API_KEY`
-- `base_url` → `LLM_BASE_URL`
-
-<Note>
-For development setups, you can also define custom named LLM configurations. See [Custom LLM Configurations](/openhands/usage/llms/custom-llm-configs) for details.
+  Legacy <code>config.toml</code> / “runtime” configuration docs have been moved
+  to the <b>Web_V0</b> tab.
 </Note>
 
-**AWS Credentials**
-- `aws_access_key_id`
-  - Type: `str`
-  - Default: `""`
-  - Description: AWS access key ID
-
-- `aws_region_name`
-  - Type: `str`
-  - Default: `""`
-  - Description: AWS region name
-
-- `aws_secret_access_key`
-  - Type: `str`
-  - Default: `""`
-  - Description: AWS secret access key
-
-### API Configuration
-- `api_key`
-  - Type: `str`
-  - Default: `None`
-  - Description: API key to use
-
-- `base_url`
-  - Type: `str`
-  - Default: `""`
-  - Description: API base URL
-
-- `api_version`
-  - Type: `str`
-  - Default: `""`
-  - Description: API version
+## Where configuration lives in V1
 
-- `input_cost_per_token`
-  - Type: `float`
-  - Default: `0.0`
-  - Description: Cost per input token
+Most user-facing configuration is done via the **Settings** UI in the Web app
+(LLM provider/model, integrations, MCP, secrets, etc.).
 
-- `output_cost_per_token`
-  - Type: `float`
-  - Default: `0.0`
-  - Description: Cost per output token
+For self-hosted deployments and advanced workflows, OpenHands also supports
+environment-variable configuration.
 
-### Custom LLM Provider
-- `custom_llm_provider`
-  - Type: `str`
-  - Default: `""`
-  - Description: Custom LLM provider
+## Common V1 environment variables
 
+These are some commonly used variables in V1 deployments:
 
-### Message Handling
-- `max_message_chars`
-  - Type: `int`
-  - Default: `30000`
-  - Description: The approximate maximum number of characters in the content of an event included in the prompt to the LLM. Larger observations are truncated.
+- **LLM credentials** (examples)
+  - <code>OPENAI_API_KEY</code>
+  - <code>ANTHROPIC_API_KEY</code>
 
-- `max_input_tokens`
-  - Type: `int`
-  - Default: `0`
-  - Description: Maximum number of input tokens
+- **Persistence**
+  - <code>OH_PERSISTENCE_DIR</code>: where OpenHands stores local state (defaults to
+    <code>~/.openhands</code>).
 
-- `max_output_tokens`
-  - Type: `int`
-  - Default: `0`
-  - Description: Maximum number of output tokens
+- **Public URL (optional)**
+  - <code>OH_WEB_URL</code>: the externally reachable URL of your OpenHands instance
+    (used for callbacks in some deployments).
 
-### Model Selection
-- `model`
-  - Type: `str`
-  - Default: `"claude-3-5-sonnet-20241022"`
-  - Description: Model to use
+- **Sandbox workspace mounting**
+  - <code>SANDBOX_VOLUMES</code>: mount host directories into the sandbox (see
+    [Docker Sandbox](/openhands/usage/sandboxes/docker)).
 
-### Retrying
-- `num_retries`
-  - Type: `int`
-  - Default: `8`
-  - Description: Number of retries to attempt
+- **Sandbox image selection**
+  - <code>AGENT_SERVER_IMAGE_REPOSITORY</code>
+  - <code>AGENT_SERVER_IMAGE_TAG</code>
 
-- `retry_max_wait`
-  - Type: `int`
-  - Default: `120`
-  - Description: Maximum wait time (in seconds) between retry attempts
+## Need legacy options?
 
-- `retry_min_wait`
-  - Type: `int`
-  - Default: `15`
-  - Description: Minimum wait time (in seconds) between retry attempts
-
-- `retry_multiplier`
-  - Type: `float`
-  - Default: `2.0`
-  - Description: Multiplier for exponential backoff calculation
-
-### Advanced Options
-- `drop_params`
-  - Type: `bool`
-  - Default: `false`
-  - Description: Drop any unmapped (unsupported) params without causing an exception
-
-- `caching_prompt`
-  - Type: `bool`
-  - Default: `true`
-  - Description: Using the prompt caching feature if provided by the LLM and supported
-
-- `ollama_base_url`
-  - Type: `str`
-  - Default: `""`
-  - Description: Base URL for the OLLAMA API
-
-- `temperature`
-  - Type: `float`
-  - Default: `0.0`
-  - Description: Temperature for the API
-
-- `timeout`
-  - Type: `int`
-  - Default: `0`
-  - Description: Timeout for the API
-
-- `top_p`
-  - Type: `float`
-  - Default: `1.0`
-  - Description: Top p for the API
-
-- `disable_vision`
-  - Type: `bool`
-  - Default: `None`
-  - Description: If model is vision capable, this option allows to disable image processing (useful for cost reduction)
-
-## Agent Configuration
-
-The agent configuration options are defined in the `[agent]` and `[agent.<agent_name>]` sections of the `config.toml` file.
-
-Agent configuration options can be set as environment variables by prefixing with `AGENT_` and converting to uppercase. For example:
-- `enable_browsing` → `AGENT_ENABLE_BROWSING`
-- `function_calling` → `AGENT_FUNCTION_CALLING`
-- `llm_config` → `AGENT_LLM_CONFIG`
-
-### LLM Configuration
-- `llm_config`
-  - Type: `str`
-  - Default: `'your-llm-config-group'`
-  - Description: The name of the LLM config to use
-
-### ActionSpace Configuration
-- `function_calling`
-  - Type: `bool`
-  - Default: `true`
-  - Description: Whether function calling is enabled
-
-- `enable_browsing`
-  - Type: `bool`
-  - Default: `false`
-  - Description: Whether browsing delegate is enabled in the action space (only works with function calling)
-
-- `enable_llm_editor`
-  - Type: `bool`
-  - Default: `false`
-  - Description: Whether LLM editor is enabled in the action space (only works with function calling)
-
-- `enable_jupyter`
-  - Type: `bool`
-  - Default: `false`
-  - Description: Whether Jupyter is enabled in the action space
-
-- `enable_history_truncation`
-  - Type: `bool`
-  - Default: `true`
-  - Description: Whether history should be truncated to continue the session when hitting LLM context length limit
-
-### Skills (formerly Microagents) Usage
-- `enable_prompt_extensions`
-  - Type: `bool`
-  - Default: `true`
-  - Description: Whether to use skills at all
-
-- `disabled_microagents`
-  - Type: `list of str`
-  - Default: `None`
-  - Description: A list of skills to disable
-
-## Sandbox Configuration
-
-The sandbox configuration options are defined in the `[sandbox]` section of the `config.toml` file.
-
-
-
-To use these with the docker command, pass in `-e SANDBOX_<option>`. Example: `-e SANDBOX_TIMEOUT`.
-
-All sandbox configuration options can be set as environment variables by prefixing with `SANDBOX_` and converting to uppercase. For example:
-- `timeout` → `SANDBOX_TIMEOUT`
-- `user_id` → `SANDBOX_USER_ID`
-- `base_container_image` → `SANDBOX_BASE_CONTAINER_IMAGE`
-
-### Execution
-- `timeout`
-  - Type: `int`
-  - Default: `120`
-  - Description: Sandbox timeout in seconds
-
-- `user_id`
-  - Type: `int`
-  - Default: `1000`
-  - Description: Sandbox user ID
-
-### Container Image
-- `base_container_image`
-  - Type: `str`
-  - Default: `"nikolaik/python-nodejs:python3.12-nodejs22"`
-  - Description: Container image to use for the sandbox
-
-### Networking
-- `use_host_network`
-  - Type: `bool`
-  - Default: `false`
-  - Description: Use host network
-
-- `runtime_binding_address`
-  - Type: `str`
-  - Default: `0.0.0.0`
-  - Description: The binding address for the runtime ports.  It specifies which network interface on the host machine Docker should bind the runtime ports to.
-
-### Linting and Plugins
-- `enable_auto_lint`
-  - Type: `bool`
-  - Default: `false`
-  - Description: Enable auto linting after editing
-
-- `initialize_plugins`
-  - Type: `bool`
-  - Default: `true`
-  - Description: Whether to initialize plugins
-
-### Dependencies and Environment
-- `runtime_extra_deps`
-  - Type: `str`
-  - Default: `""`
-  - Description: Extra dependencies to install in the runtime image
-
-- `runtime_startup_env_vars`
-  - Type: `dict`
-  - Default: `{}`
-  - Description: Environment variables to set at the launch of the runtime
-
-### Evaluation
-- `browsergym_eval_env`
-  - Type: `str`
-  - Default: `""`
-  - Description: BrowserGym environment to use for evaluation
-
-## Security Configuration
-
-The security configuration options are defined in the `[security]` section of the `config.toml` file.
-
-To use these with the docker command, pass in `-e SECURITY_<option>`. Example: `-e SECURITY_CONFIRMATION_MODE`.
-
-All security configuration options can be set as environment variables by prefixing with `SECURITY_` and converting to uppercase. For example:
-- `confirmation_mode` → `SECURITY_CONFIRMATION_MODE`
-- `security_analyzer` → `SECURITY_SECURITY_ANALYZER`
-
-### Confirmation Mode
-- `confirmation_mode`
-  - Type: `bool`
-  - Default: `false`
-  - Description: Enable confirmation mode
-
-### Security Analyzer
-- `security_analyzer`
-  - Type: `str`
-  - Default: `""`
-  - Description: The security analyzer to use
-
----
+If you are looking for the old <code>config.toml</code> reference or V0 “runtime”
+providers, see:
 
-> **Note**: Adjust configurations carefully, especially for memory, security, and network-related settings to ensure optimal performance and security.
-Please note that the configuration options may be subject to change in future versions of OpenHands. It's recommended to refer to the official documentation for the most up-to-date information.
+- <b>Web_V0 → V0 Configuration Options</b>
+- <b>Web_V0 → V0 Runtime Configuration</b>
diff --git a/openhands/usage/api/v1.mdx b/openhands/usage/api/v1.mdx
new file mode 100644
index 000000000..03f287f20
--- /dev/null
+++ b/openhands/usage/api/v1.mdx
@@ -0,0 +1,42 @@
+---
+title: REST API (V1)
+description: Overview of the current V1 REST endpoints used by the Web app.
+---
+
+<Note>
+  OpenHands is in a transition period: legacy (V0) endpoints still exist alongside
+  the new <code>/api/v1</code> endpoints.
+
+  If you need the legacy OpenAPI reference, see the <b>Web_V0</b> tab.
+</Note>
+
+## Overview
+
+OpenHands V1 REST endpoints are mounted under:
+
+- <code>/api/v1</code>
+
+These endpoints back the current Web UI and are intended for newer integrations.
+
+## Key resources
+
+The V1 API is organized around a few core concepts:
+
+- **App conversations**: create/list conversations and access conversation metadata.
+  - <code>POST /api/v1/app-conversations</code>
+  - <code>GET /api/v1/app-conversations</code>
+
+- **Sandboxes**: list/start/pause/resume the execution environments that power conversations.
+  - <code>GET /api/v1/sandboxes/search</code>
+  - <code>POST /api/v1/sandboxes</code>
+  - <code>POST /api/v1/sandboxes/{id}/pause</code>
+  - <code>POST /api/v1/sandboxes/{id}/resume</code>
+
+- **Sandbox specs**: list the available sandbox “templates” (e.g., Docker image presets).
+  - <code>GET /api/v1/sandbox-specs/search</code>
+
+## Notes on stability
+
+The V1 API surface is still evolving. If you are building something that needs a
+stable contract, consider starting with the legacy (V0) endpoints while we
+finish the V1 migration, and keep an eye on release notes for breaking changes.
diff --git a/openhands/usage/cli/gui-server.mdx b/openhands/usage/cli/gui-server.mdx
index cbbeebb1d..5c896c657 100644
--- a/openhands/usage/cli/gui-server.mdx
+++ b/openhands/usage/cli/gui-server.mdx
@@ -135,4 +135,4 @@ If port 3000 is already in use, stop the conflicting service or use a different
 
 - [Local GUI Setup](/openhands/usage/run-openhands/local-setup) - Detailed GUI setup guide
 - [Web Interface](/openhands/usage/cli/web-interface) - Lightweight browser access
-- [Docker Runtime](/openhands/usage/runtimes/docker) - Docker configuration details
+- [Docker Sandbox](/openhands/usage/sandboxes/docker) - Docker sandbox configuration details
diff --git a/openhands/usage/cli/installation.mdx b/openhands/usage/cli/installation.mdx
index 4849540a6..c6d9fddb8 100644
--- a/openhands/usage/cli/installation.mdx
+++ b/openhands/usage/cli/installation.mdx
@@ -55,7 +55,7 @@ description: Install the OpenHands CLI on your system
   </Tab>
   <Tab title="Using Docker">
     1. Set the following environment variable in your terminal:
-       - `SANDBOX_VOLUMES` to specify the directory you want OpenHands to access ([See using SANDBOX_VOLUMES for more info](/openhands/usage/runtimes/docker#using-sandbox_volumes))
+       - `SANDBOX_VOLUMES` to specify the directory you want OpenHands to access ([See using SANDBOX_VOLUMES for more info](/openhands/usage/sandboxes/docker#using-sandbox_volumes))
 
     2. Ensure you have configured your settings before starting:
        - Set up `~/.openhands/settings.json` with your LLM configuration
diff --git a/openhands/usage/llms/openhands-llms.mdx b/openhands/usage/llms/openhands-llms.mdx
index 3c1cf9848..bd11071c7 100644
--- a/openhands/usage/llms/openhands-llms.mdx
+++ b/openhands/usage/llms/openhands-llms.mdx
@@ -85,17 +85,16 @@ Pricing follows official API provider rates. Below are the current pricing detai
 |-------|----------------------------|-----------------------------------|------------------------------|------------------|-------------------|
 | claude-sonnet-4-5-20250929 | $3.00 | $0.30 | $15.00 | 200,000 | 64,000 |
 | claude-sonnet-4-20250514 | $3.00 | $0.30 | $15.00 | 1,000,000 | 64,000 |
+| claude-opus-4-5-20251101 | $5.00 | $0.50 | $25.00 | 200,000 | 64,000 |
 | claude-opus-4-20250514 | $15.00 | $1.50 | $75.00 | 200,000 | 32,000 |
-| claude-opus-4-1-20250805 | $15.00 | $1.50 | $75.00 | 200,000 | 32,000 |
-| claude-haiku-4-5-20251001 | $1.00 | $0.10 | $5.00 | 200,000 | 64,000 |
-| gpt-5-codex | $1.25 | $0.125 | $10.00 | 272,000 | 128,000 |
 | gpt-5-2025-08-07 | $1.25 | $0.125 | $10.00 | 272,000 | 128,000 |
 | gpt-5-mini-2025-08-07 | $0.25 | $0.025 | $2.00 | 272,000 | 128,000 |
-| devstral-medium-2507 | $0.40 | N/A | $2.00 | 128,000 | 128,000 |
-| devstral-small-2507 | $0.10 | N/A | $0.30 | 128,000 | 128,000 |
+| gemini-2.5-pro | $1.25 | $0.125 | $10.00 | 1,048,576 | 65,535 |
 | o3 | $2.00 | $0.50 | $8.00 | 200,000 | 100,000 |
 | o4-mini | $1.10 | $0.275 | $4.40 | 200,000 | 100,000 |
-| gemini-3-pro-preview | $2.00 | $0.20 | $12.00 | 1,048,576 | 65,535 |
+| devstral-small-2505 | $0.10 | N/A | $0.30 | 128,000 | 128,000 |
+| devstral-small-2507 | $0.10 | N/A | $0.30 | 128,000 | 128,000 |
+| devstral-medium-2507 | $0.40 | N/A | $2.00 | 128,000 | 128,000 |
 | kimi-k2-0711-preview | $0.60 | $0.15 | $2.50 | 131,072 | 131,072 |
 | qwen3-coder-480b | $0.40 | N/A | $1.60 | N/A | N/A |
 
diff --git a/openhands/usage/run-openhands/local-setup.mdx b/openhands/usage/run-openhands/local-setup.mdx
index 56a6514fd..0c6e34376 100644
--- a/openhands/usage/run-openhands/local-setup.mdx
+++ b/openhands/usage/run-openhands/local-setup.mdx
@@ -230,7 +230,7 @@ This version is unstable and is recommended for testing or development purposes
 
 ## Next Steps
 
-- [Connect OpenHands to your local filesystem.](/openhands/usage/runtimes/docker#connecting-to-your-filesystem) to use OpenHands with your GitHub repositories
+- [Mount your local code into the sandbox](/openhands/usage/sandboxes/docker#mounting-your-code-into-the-sandbox) to use OpenHands with your repositories
 - [Run OpenHands in a scriptable headless mode.](/openhands/usage/run-openhands/headless-mode)
 - [Run OpenHands with a friendly CLI.](/openhands/usage/run-openhands/cli-mode)
 - [Run OpenHands on tagged issues with a GitHub action.](/openhands/usage/run-openhands/github-action)
diff --git a/openhands/usage/runtimes/overview.mdx b/openhands/usage/runtimes/overview.mdx
deleted file mode 100644
index 47ef4eeed..000000000
--- a/openhands/usage/runtimes/overview.mdx
+++ /dev/null
@@ -1,40 +0,0 @@
----
-title: Overview
-description: This section is for users that would like to use a runtime other than Docker for OpenHands.
----
-
-<Note>
-  These settings are only available in [Local GUI](/openhands/usage/run-openhands/local-setup). OpenHands Cloud uses managed sandbox environments.
-</Note>
-
-A Runtime is an environment where the OpenHands agent can edit files and run
-commands.
-
-By default, OpenHands uses a [Docker-based runtime](/usage/runtimes/docker), running on your local computer.
-This means you only have to pay for the LLM you're using, and your code is only ever sent to the LLM.
-
-Additionally, we provide a [Local Runtime](/usage/runtimes/local) that runs directly on your machine without Docker,
-which can be useful in controlled environments like CI pipelines.
-
-## Available Runtimes
-
-OpenHands supports several different runtime environments:
-
-- [Docker Runtime](/usage/runtimes/docker) - The default runtime that uses Docker containers for isolation (recommended for most users).
-- [OpenHands Remote Runtime](/usage/runtimes/remote) - Cloud-based runtime for parallel execution (beta).
-- [Local Runtime](/usage/runtimes/local) - Direct execution on your local machine without Docker.
-
-### Third-Party Runtimes
-
-The following third-party runtimes are available when you install the `third_party_runtimes` extra:
-
-```bash
-pip install openhands-ai[third_party_runtimes]
-```
-
-- [E2B Runtime](/usage/runtimes/e2b) - Open source runtime using E2B sandboxes.
-- [Modal Runtime](/usage/runtimes/modal) - Serverless runtime using Modal infrastructure.
-- [Runloop Runtime](/usage/runtimes/runloop) - Cloud runtime using Runloop infrastructure.
-- [Daytona Runtime](/usage/runtimes/daytona) - Development environment runtime using Daytona.
-
-**Note**: These third-party runtimes are supported by their respective developers, not by the OpenHands team. For issues specific to these runtimes, please refer to their documentation or contact their support teams.
diff --git a/openhands/usage/sandboxes/docker.mdx b/openhands/usage/sandboxes/docker.mdx
new file mode 100644
index 000000000..4f68738e9
--- /dev/null
+++ b/openhands/usage/sandboxes/docker.mdx
@@ -0,0 +1,46 @@
+---
+title: Docker Sandbox
+description: The recommended sandbox provider for running OpenHands locally.
+---
+
+The **Docker sandbox** runs the agent server inside a Docker container. This is
+the default and recommended option for most users.
+
+## Why Docker?
+
+- Isolation: reduces risk when the agent runs commands.
+- Reproducibility: consistent environment across machines.
+
+## Mounting your code into the sandbox
+
+If you want OpenHands to work directly on a local repository, mount it into the
+sandbox.
+
+### Recommended: CLI launcher
+
+If you start OpenHands via:
+
+```bash
+openhands serve --mount-cwd
+```
+
+your current directory will be mounted into the sandbox workspace.
+
+### Using SANDBOX_VOLUMES
+
+You can also configure mounts via the <code>SANDBOX_VOLUMES</code> environment
+variable (format: <code>host_path:container_path[:mode]</code>):
+
+```bash
+export SANDBOX_VOLUMES=$PWD:/workspace:rw
+```
+
+<Note>
+  Anything mounted read-write into <code>/workspace</code> can be modified by the
+  agent.
+</Note>
+
+## Custom sandbox images
+
+To customize the container image (extra tools, system deps, etc.), see
+[Custom Sandbox Guide](/openhands/usage/advanced/custom-sandbox-guide).
diff --git a/openhands/usage/sandboxes/overview.mdx b/openhands/usage/sandboxes/overview.mdx
new file mode 100644
index 000000000..82b254bb6
--- /dev/null
+++ b/openhands/usage/sandboxes/overview.mdx
@@ -0,0 +1,30 @@
+---
+title: Overview
+description: Where OpenHands runs code in V1: Docker sandbox, Process, or Remote.
+---
+
+A **sandbox** is the environment where OpenHands runs commands, edits files, and
+starts servers while working on your task.
+
+In **OpenHands V1**, we use the term **sandbox** (not “runtime”) for this concept.
+
+## Sandbox providers
+
+OpenHands supports multiple sandbox “providers”, with different tradeoffs:
+
+- **Docker sandbox (recommended)**
+  - Runs the agent server inside a Docker container.
+  - Good isolation from your host machine.
+
+- **Process sandbox (unsafe, but fast)**
+  - Runs the agent server as a regular process on your machine.
+  - No container isolation.
+
+- **Remote sandbox**
+  - Runs the agent server in a remote environment.
+  - Used by managed deployments and some hosted setups.
+
+## Terminology note (V0 vs V1)
+
+Older documentation refers to these environments as **runtimes**.
+Those legacy docs are now in the <b>Web_V0</b> tab.
diff --git a/openhands/usage/sandboxes/process.mdx b/openhands/usage/sandboxes/process.mdx
new file mode 100644
index 000000000..d721aac8d
--- /dev/null
+++ b/openhands/usage/sandboxes/process.mdx
@@ -0,0 +1,30 @@
+---
+title: Process Sandbox (Unsafe)
+description: Run the agent server as a local process without container isolation.
+---
+
+The **Process sandbox** runs the agent server directly on your machine as a
+regular process.
+
+<Warning>
+  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.
+</Warning>
+
+## When to use it
+
+- Local development when Docker is unavailable
+- Some CI environments
+- Debugging issues that only reproduce outside containers
+
+## Choosing process mode
+
+Exact configuration depends on how you run OpenHands (CLI launcher, Docker, or
+a self-hosted deployment). In some setups this may still be exposed under a
+legacy “runtime” selector.
+
+If you are unsure, prefer the [Docker Sandbox](/openhands/usage/sandboxes/docker).
diff --git a/openhands/usage/sandboxes/remote.mdx b/openhands/usage/sandboxes/remote.mdx
new file mode 100644
index 000000000..8e88637e6
--- /dev/null
+++ b/openhands/usage/sandboxes/remote.mdx
@@ -0,0 +1,18 @@
+---
+title: Remote Sandbox
+description: Run conversations in a remote sandbox environment.
+---
+
+A **remote sandbox** runs the agent server in a remote execution environment
+instead of on your local machine.
+
+This is typically used by managed deployments (e.g., OpenHands Cloud) and
+advanced self-hosted setups.
+
+## Notes
+
+- Remote sandboxes may expose additional service URLs (e.g., VS Code, app ports)
+  depending on the provider.
+- Configuration and credentials vary by deployment.
+
+If you are using OpenHands Cloud, see the [Cloud UI guide](/openhands/usage/cloud/cloud-ui).
diff --git a/openhands/usage/v0/advanced/V0_configuration-options.mdx b/openhands/usage/v0/advanced/V0_configuration-options.mdx
new file mode 100644
index 000000000..3116a8f64
--- /dev/null
+++ b/openhands/usage/v0/advanced/V0_configuration-options.mdx
@@ -0,0 +1,446 @@
+---
+title: V0_Configuration Options
+description: This page outlines all available configuration options for OpenHands, allowing you to customize its
+  behavior and integrate it with other services.
+---
+<Note>
+  This page documents **legacy OpenHands V0** behavior. For the current V1
+  sandbox model, see [Sandboxes (V1)](/openhands/usage/sandboxes/overview).
+</Note>
+
+
+<Note>
+  These settings are only available in [Local GUI](/openhands/usage/run-openhands/local-setup). OpenHands Cloud uses a web-based settings interface.
+</Note>
+
+<Note>
+   In GUI Mode, any settings applied through the Settings UI will take precedence.
+</Note>
+
+<Note>
+   **Looking for Environment Variables?** All configuration options can also be set using environment variables. 
+   See the [Environment Variables Reference](/openhands/usage/environment-variables) for a complete list with examples.
+</Note>
+
+## Location of the `config.toml` File
+
+When running OpenHands in CLI, headless, or development mode, you can use a project-specific `config.toml` file for configuration, which must be
+located in the same directory from which the command is run. Alternatively, you may use the `--config-file` option to
+specify a different path to the `config.toml` file.
+
+## Core Configuration
+
+The core configuration options are defined in the `[core]` section of the `config.toml` file.
+
+Core configuration options can be set as environment variables by converting to uppercase. For example:
+- `debug` → `DEBUG`
+- `cache_dir` → `CACHE_DIR`
+- `runtime` → `RUNTIME`
+
+### Workspace
+- `workspace_base` **(Deprecated)**
+  - Type: `str`
+  - Default: `"./workspace"`
+  - Description: Base path for the workspace. **Deprecated: Use `SANDBOX_VOLUMES` instead.**
+
+- `cache_dir`
+  - Type: `str`
+  - Default: `"/tmp/cache"`
+  - Description: Cache directory path
+
+### Debugging and Logging
+- `debug`
+  - Type: `bool`
+  - Default: `false`
+  - Description: Enable debugging
+
+- `disable_color`
+  - Type: `bool`
+  - Default: `false`
+  - Description: Disable color in terminal output
+
+### Trajectories
+- `save_trajectory_path`
+  - Type: `str`
+  - Default: `"./trajectories"`
+  - Description: Path to store trajectories (can be a folder or a file). If it's a folder, the trajectories will be saved in a file named with the session id name and .json extension, in that folder.
+
+- `replay_trajectory_path`
+  - Type: `str`
+  - Default: `""`
+  - Description: Path to load a trajectory and replay. If given, must be a path to the trajectory file in JSON format. The actions in the trajectory file would be replayed first before any user instruction is executed.
+
+### File Store
+- `file_store_path`
+  - Type: `str`
+  - Default: `"/tmp/file_store"`
+  - Description: File store path
+
+- `file_store`
+  - Type: `str`
+  - Default: `"memory"`
+  - Description: File store type
+
+- `file_uploads_allowed_extensions`
+  - Type: `list of str`
+  - Default: `[".*"]`
+  - Description: List of allowed file extensions for uploads
+
+- `file_uploads_max_file_size_mb`
+  - Type: `int`
+  - Default: `0`
+  - Description: Maximum file size for uploads, in megabytes
+
+- `file_uploads_restrict_file_types`
+  - Type: `bool`
+  - Default: `false`
+  - Description: Restrict file types for file uploads
+
+- `file_uploads_allowed_extensions`
+  - Type: `list of str`
+  - Default: `[".*"]`
+  - Description: List of allowed file extensions for uploads
+
+### Task Management
+- `max_budget_per_task`
+  - Type: `float`
+  - Default: `0.0`
+  - Description: Maximum budget per task (0.0 means no limit)
+
+- `max_iterations`
+  - Type: `int`
+  - Default: `100`
+  - Description: Maximum number of iterations
+
+### Sandbox Configuration
+- `volumes`
+  - Type: `str`
+  - Default: `None`
+  - Description: Volume mounts in the format 'host_path:container_path[:mode]', e.g. '/my/host/dir:/workspace:rw'. Multiple mounts can be specified using commas, e.g. '/path1:/workspace/path1,/path2:/workspace/path2:ro'
+
+- `workspace_mount_path_in_sandbox` **(Deprecated)**
+  - Type: `str`
+  - Default: `"/workspace"`
+  - Description: Path to mount the workspace in the sandbox. **Deprecated: Use `SANDBOX_VOLUMES` instead.**
+
+- `workspace_mount_path` **(Deprecated)**
+  - Type: `str`
+  - Default: `""`
+  - Description: Path to mount the workspace. **Deprecated: Use `SANDBOX_VOLUMES` instead.**
+
+- `workspace_mount_rewrite` **(Deprecated)**
+  - Type: `str`
+  - Default: `""`
+  - Description: Path to rewrite the workspace mount path to. You can usually ignore this, it refers to special cases of running inside another container. **Deprecated: Use `SANDBOX_VOLUMES` instead.**
+
+### Miscellaneous
+- `run_as_openhands`
+  - Type: `bool`
+  - Default: `true`
+  - Description: Run as OpenHands
+
+- `runtime`
+  - Type: `str`
+  - Default: `"docker"`
+  - Description: Runtime environment
+
+- `default_agent`
+  - Type: `str`
+  - Default: `"CodeActAgent"`
+  - Description: Name of the default agent
+
+- `jwt_secret`
+  - Type: `str`
+  - Default: `uuid.uuid4().hex`
+  - Description: JWT secret for authentication. Please set it to your own value.
+
+## LLM Configuration
+
+The LLM (Large Language Model) configuration options are defined in the `[llm]` section of the `config.toml` file.
+
+To use these with the docker command, pass in `-e LLM_<option>`. Example: `-e LLM_NUM_RETRIES`.
+
+All LLM configuration options can be set as environment variables by prefixing with `LLM_` and converting to uppercase. For example:
+- `model` → `LLM_MODEL`
+- `api_key` → `LLM_API_KEY`
+- `base_url` → `LLM_BASE_URL`
+
+<Note>
+For development setups, you can also define custom named LLM configurations. See [Custom LLM Configurations](/openhands/usage/llms/custom-llm-configs) for details.
+</Note>
+
+**AWS Credentials**
+- `aws_access_key_id`
+  - Type: `str`
+  - Default: `""`
+  - Description: AWS access key ID
+
+- `aws_region_name`
+  - Type: `str`
+  - Default: `""`
+  - Description: AWS region name
+
+- `aws_secret_access_key`
+  - Type: `str`
+  - Default: `""`
+  - Description: AWS secret access key
+
+### API Configuration
+- `api_key`
+  - Type: `str`
+  - Default: `None`
+  - Description: API key to use
+
+- `base_url`
+  - Type: `str`
+  - Default: `""`
+  - Description: API base URL
+
+- `api_version`
+  - Type: `str`
+  - Default: `""`
+  - Description: API version
+
+- `input_cost_per_token`
+  - Type: `float`
+  - Default: `0.0`
+  - Description: Cost per input token
+
+- `output_cost_per_token`
+  - Type: `float`
+  - Default: `0.0`
+  - Description: Cost per output token
+
+### Custom LLM Provider
+- `custom_llm_provider`
+  - Type: `str`
+  - Default: `""`
+  - Description: Custom LLM provider
+
+
+### Message Handling
+- `max_message_chars`
+  - Type: `int`
+  - Default: `30000`
+  - Description: The approximate maximum number of characters in the content of an event included in the prompt to the LLM. Larger observations are truncated.
+
+- `max_input_tokens`
+  - Type: `int`
+  - Default: `0`
+  - Description: Maximum number of input tokens
+
+- `max_output_tokens`
+  - Type: `int`
+  - Default: `0`
+  - Description: Maximum number of output tokens
+
+### Model Selection
+- `model`
+  - Type: `str`
+  - Default: `"claude-3-5-sonnet-20241022"`
+  - Description: Model to use
+
+### Retrying
+- `num_retries`
+  - Type: `int`
+  - Default: `8`
+  - Description: Number of retries to attempt
+
+- `retry_max_wait`
+  - Type: `int`
+  - Default: `120`
+  - Description: Maximum wait time (in seconds) between retry attempts
+
+- `retry_min_wait`
+  - Type: `int`
+  - Default: `15`
+  - Description: Minimum wait time (in seconds) between retry attempts
+
+- `retry_multiplier`
+  - Type: `float`
+  - Default: `2.0`
+  - Description: Multiplier for exponential backoff calculation
+
+### Advanced Options
+- `drop_params`
+  - Type: `bool`
+  - Default: `false`
+  - Description: Drop any unmapped (unsupported) params without causing an exception
+
+- `caching_prompt`
+  - Type: `bool`
+  - Default: `true`
+  - Description: Using the prompt caching feature if provided by the LLM and supported
+
+- `ollama_base_url`
+  - Type: `str`
+  - Default: `""`
+  - Description: Base URL for the OLLAMA API
+
+- `temperature`
+  - Type: `float`
+  - Default: `0.0`
+  - Description: Temperature for the API
+
+- `timeout`
+  - Type: `int`
+  - Default: `0`
+  - Description: Timeout for the API
+
+- `top_p`
+  - Type: `float`
+  - Default: `1.0`
+  - Description: Top p for the API
+
+- `disable_vision`
+  - Type: `bool`
+  - Default: `None`
+  - Description: If model is vision capable, this option allows to disable image processing (useful for cost reduction)
+
+## Agent Configuration
+
+The agent configuration options are defined in the `[agent]` and `[agent.<agent_name>]` sections of the `config.toml` file.
+
+Agent configuration options can be set as environment variables by prefixing with `AGENT_` and converting to uppercase. For example:
+- `enable_browsing` → `AGENT_ENABLE_BROWSING`
+- `function_calling` → `AGENT_FUNCTION_CALLING`
+- `llm_config` → `AGENT_LLM_CONFIG`
+
+### LLM Configuration
+- `llm_config`
+  - Type: `str`
+  - Default: `'your-llm-config-group'`
+  - Description: The name of the LLM config to use
+
+### ActionSpace Configuration
+- `function_calling`
+  - Type: `bool`
+  - Default: `true`
+  - Description: Whether function calling is enabled
+
+- `enable_browsing`
+  - Type: `bool`
+  - Default: `false`
+  - Description: Whether browsing delegate is enabled in the action space (only works with function calling)
+
+- `enable_llm_editor`
+  - Type: `bool`
+  - Default: `false`
+  - Description: Whether LLM editor is enabled in the action space (only works with function calling)
+
+- `enable_jupyter`
+  - Type: `bool`
+  - Default: `false`
+  - Description: Whether Jupyter is enabled in the action space
+
+- `enable_history_truncation`
+  - Type: `bool`
+  - Default: `true`
+  - Description: Whether history should be truncated to continue the session when hitting LLM context length limit
+
+### Skills (formerly Microagents) Usage
+- `enable_prompt_extensions`
+  - Type: `bool`
+  - Default: `true`
+  - Description: Whether to use skills at all
+
+- `disabled_microagents`
+  - Type: `list of str`
+  - Default: `None`
+  - Description: A list of skills to disable
+
+## Sandbox Configuration
+
+The sandbox configuration options are defined in the `[sandbox]` section of the `config.toml` file.
+
+
+
+To use these with the docker command, pass in `-e SANDBOX_<option>`. Example: `-e SANDBOX_TIMEOUT`.
+
+All sandbox configuration options can be set as environment variables by prefixing with `SANDBOX_` and converting to uppercase. For example:
+- `timeout` → `SANDBOX_TIMEOUT`
+- `user_id` → `SANDBOX_USER_ID`
+- `base_container_image` → `SANDBOX_BASE_CONTAINER_IMAGE`
+
+### Execution
+- `timeout`
+  - Type: `int`
+  - Default: `120`
+  - Description: Sandbox timeout in seconds
+
+- `user_id`
+  - Type: `int`
+  - Default: `1000`
+  - Description: Sandbox user ID
+
+### Container Image
+- `base_container_image`
+  - Type: `str`
+  - Default: `"nikolaik/python-nodejs:python3.12-nodejs22"`
+  - Description: Container image to use for the sandbox
+
+### Networking
+- `use_host_network`
+  - Type: `bool`
+  - Default: `false`
+  - Description: Use host network
+
+- `runtime_binding_address`
+  - Type: `str`
+  - Default: `0.0.0.0`
+  - Description: The binding address for the runtime ports.  It specifies which network interface on the host machine Docker should bind the runtime ports to.
+
+### Linting and Plugins
+- `enable_auto_lint`
+  - Type: `bool`
+  - Default: `false`
+  - Description: Enable auto linting after editing
+
+- `initialize_plugins`
+  - Type: `bool`
+  - Default: `true`
+  - Description: Whether to initialize plugins
+
+### Dependencies and Environment
+- `runtime_extra_deps`
+  - Type: `str`
+  - Default: `""`
+  - Description: Extra dependencies to install in the runtime image
+
+- `runtime_startup_env_vars`
+  - Type: `dict`
+  - Default: `{}`
+  - Description: Environment variables to set at the launch of the runtime
+
+### Evaluation
+- `browsergym_eval_env`
+  - Type: `str`
+  - Default: `""`
+  - Description: BrowserGym environment to use for evaluation
+
+## Security Configuration
+
+The security configuration options are defined in the `[security]` section of the `config.toml` file.
+
+To use these with the docker command, pass in `-e SECURITY_<option>`. Example: `-e SECURITY_CONFIRMATION_MODE`.
+
+All security configuration options can be set as environment variables by prefixing with `SECURITY_` and converting to uppercase. For example:
+- `confirmation_mode` → `SECURITY_CONFIRMATION_MODE`
+- `security_analyzer` → `SECURITY_SECURITY_ANALYZER`
+
+### Confirmation Mode
+- `confirmation_mode`
+  - Type: `bool`
+  - Default: `false`
+  - Description: Enable confirmation mode
+
+### Security Analyzer
+- `security_analyzer`
+  - Type: `str`
+  - Default: `""`
+  - Description: The security analyzer to use
+
+---
+
+> **Note**: Adjust configurations carefully, especially for memory, security, and network-related settings to ensure optimal performance and security.
+Please note that the configuration options may be subject to change in future versions of OpenHands. It's recommended to refer to the official documentation for the most up-to-date information.
diff --git a/openhands/usage/runtimes/daytona.mdx b/openhands/usage/v0/runtimes/V0_daytona.mdx
similarity index 88%
rename from openhands/usage/runtimes/daytona.mdx
rename to openhands/usage/v0/runtimes/V0_daytona.mdx
index 326c81d47..080c41a45 100644
--- a/openhands/usage/runtimes/daytona.mdx
+++ b/openhands/usage/v0/runtimes/V0_daytona.mdx
@@ -1,7 +1,12 @@
 ---
-title: Daytona Runtime
+title: V0_Daytona Runtime
 description: You can use [Daytona](https://www.daytona.io/) as a runtime provider.
 ---
+<Note>
+  This page documents **legacy OpenHands V0** behavior. For the current V1
+  sandbox model, see [Sandboxes (V1)](/openhands/usage/sandboxes/overview).
+</Note>
+
 
 ## Step 1: Retrieve Your Daytona API Key
 1. Visit the [Daytona Dashboard](https://app.daytona.io/dashboard/keys).
diff --git a/openhands/usage/runtimes/docker.mdx b/openhands/usage/v0/runtimes/V0_docker.mdx
similarity index 96%
rename from openhands/usage/runtimes/docker.mdx
rename to openhands/usage/v0/runtimes/V0_docker.mdx
index 9c0b4284e..8fa13b529 100644
--- a/openhands/usage/runtimes/docker.mdx
+++ b/openhands/usage/v0/runtimes/V0_docker.mdx
@@ -1,7 +1,12 @@
 ---
-title: Docker Runtime
+title: V0_Docker Runtime
 description: This is the default Runtime that's used when you start OpenHands.
 ---
+<Note>
+  This page documents **legacy OpenHands V0** behavior. For the current V1
+  sandbox model, see [Sandboxes (V1)](/openhands/usage/sandboxes/overview).
+</Note>
+
 
 ## Image
 The runtime image from nikolaik is a pre-built runtime image
diff --git a/openhands/usage/runtimes/e2b.mdx b/openhands/usage/v0/runtimes/V0_e2b.mdx
similarity index 86%
rename from openhands/usage/runtimes/e2b.mdx
rename to openhands/usage/v0/runtimes/V0_e2b.mdx
index 772b1b8b0..6278337a8 100644
--- a/openhands/usage/runtimes/e2b.mdx
+++ b/openhands/usage/v0/runtimes/V0_e2b.mdx
@@ -1,7 +1,12 @@
 ---
-title: E2B Runtime
+title: V0_E2B Runtime
 description: E2B is an open-source secure cloud environment (sandbox) made for running AI-generated code and agents.
 ---
+<Note>
+  This page documents **legacy OpenHands V0** behavior. For the current V1
+  sandbox model, see [Sandboxes (V1)](/openhands/usage/sandboxes/overview).
+</Note>
+
 
 [E2B](https://e2b.dev) offers [Python](https://pypi.org/project/e2b/) and [JS/TS](https://www.npmjs.com/package/e2b)
 SDK to spawn and control these sandboxes.
diff --git a/openhands/usage/runtimes/local.mdx b/openhands/usage/v0/runtimes/V0_local.mdx
similarity index 93%
rename from openhands/usage/runtimes/local.mdx
rename to openhands/usage/v0/runtimes/V0_local.mdx
index 4cbf0c90a..07c89a3fa 100644
--- a/openhands/usage/runtimes/local.mdx
+++ b/openhands/usage/v0/runtimes/V0_local.mdx
@@ -1,9 +1,14 @@
 ---
-title: Local Runtime
+title: V0_Local Runtime
 description: The Local Runtime allows the OpenHands agent to execute actions directly on your local machine without
   using Docker. This runtime is primarily intended for controlled environments like CI pipelines or testing scenarios
   where Docker is not available.
 ---
+<Note>
+  This page documents **legacy OpenHands V0** behavior. For the current V1
+  sandbox model, see [Sandboxes (V1)](/openhands/usage/sandboxes/overview).
+</Note>
+
 
 <Warning>
 **Security Warning**: The Local Runtime runs without any sandbox isolation. The agent can directly access and modify
diff --git a/openhands/usage/runtimes/modal.mdx b/openhands/usage/v0/runtimes/V0_modal.mdx
similarity index 68%
rename from openhands/usage/runtimes/modal.mdx
rename to openhands/usage/v0/runtimes/V0_modal.mdx
index c5702ec24..d201a0b2b 100644
--- a/openhands/usage/runtimes/modal.mdx
+++ b/openhands/usage/v0/runtimes/V0_modal.mdx
@@ -1,6 +1,11 @@
 ---
-title: Modal Runtime
+title: V0_Modal Runtime
 ---
+<Note>
+  This page documents **legacy OpenHands V0** behavior. For the current V1
+  sandbox model, see [Sandboxes (V1)](/openhands/usage/sandboxes/overview).
+</Note>
+
 
 Our partners at [Modal](https://modal.com/) have provided a runtime for OpenHands.
 To use the Modal Runtime, create an account, and then [create an API key.](https://modal.com/settings)
diff --git a/openhands/usage/v0/runtimes/V0_overview.mdx b/openhands/usage/v0/runtimes/V0_overview.mdx
new file mode 100644
index 000000000..d11244a81
--- /dev/null
+++ b/openhands/usage/v0/runtimes/V0_overview.mdx
@@ -0,0 +1,45 @@
+---
+title: V0_Overview
+description: This section is for users that would like to use a runtime other than Docker for OpenHands.
+---
+<Note>
+  This page documents **legacy OpenHands V0** behavior. For the current V1
+  sandbox model, see [Sandboxes (V1)](/openhands/usage/sandboxes/overview).
+</Note>
+
+
+<Note>
+  These settings are only available in [Local GUI](/openhands/usage/run-openhands/local-setup). OpenHands Cloud uses managed sandbox environments.
+</Note>
+
+A Runtime is an environment where the OpenHands agent can edit files and run
+commands.
+
+By default, OpenHands uses a [Docker-based runtime](/openhands/usage/v0/runtimes/V0_docker), running on your local computer.
+This means you only have to pay for the LLM you're using, and your code is only ever sent to the LLM.
+
+Additionally, we provide a [Local Runtime](/openhands/usage/v0/runtimes/V0_local) that runs directly on your machine without Docker,
+which can be useful in controlled environments like CI pipelines.
+
+## Available Runtimes
+
+OpenHands supports several different runtime environments:
+
+- [Docker Runtime](/openhands/usage/v0/runtimes/V0_docker) - The default runtime that uses Docker containers for isolation (recommended for most users).
+- [OpenHands Remote Runtime](/openhands/usage/v0/runtimes/V0_remote) - Cloud-based runtime for parallel execution (beta).
+- [Local Runtime](/openhands/usage/v0/runtimes/V0_local) - Direct execution on your local machine without Docker.
+
+### Third-Party Runtimes
+
+The following third-party runtimes are available when you install the `third_party_runtimes` extra:
+
+```bash
+pip install openhands-ai[third_party_runtimes]
+```
+
+- [E2B Runtime](/openhands/usage/v0/runtimes/V0_e2b) - Open source runtime using E2B sandboxes.
+- [Modal Runtime](/openhands/usage/v0/runtimes/V0_modal) - Serverless runtime using Modal infrastructure.
+- [Runloop Runtime](/openhands/usage/v0/runtimes/V0_runloop) - Cloud runtime using Runloop infrastructure.
+- [Daytona Runtime](/openhands/usage/v0/runtimes/V0_daytona) - Development environment runtime using Daytona.
+
+**Note**: These third-party runtimes are supported by their respective developers, not by the OpenHands team. For issues specific to these runtimes, please refer to their documentation or contact their support teams.
diff --git a/openhands/usage/runtimes/remote.mdx b/openhands/usage/v0/runtimes/V0_remote.mdx
similarity index 75%
rename from openhands/usage/runtimes/remote.mdx
rename to openhands/usage/v0/runtimes/V0_remote.mdx
index c5a33f3f6..4e9ed7c34 100644
--- a/openhands/usage/runtimes/remote.mdx
+++ b/openhands/usage/v0/runtimes/V0_remote.mdx
@@ -1,9 +1,14 @@
 ---
-title: Remote Runtime
+title: V0_Remote Runtime
 description: This runtime is specifically designed for agent evaluation purposes only through the
   [OpenHands evaluation harness](https://github.com/OpenHands/OpenHands/tree/main/evaluation). It should not be
   used to launch production OpenHands applications.
 ---
+<Note>
+  This page documents **legacy OpenHands V0** behavior. For the current V1
+  sandbox model, see [Sandboxes (V1)](/openhands/usage/sandboxes/overview).
+</Note>
+
 
 OpenHands Remote Runtime is currently in beta (read [here](https://runtime.all-hands.dev/) for more details),
 it allows you to launch runtimes in parallel in the cloud. Fill out
diff --git a/openhands/usage/runtimes/runloop.mdx b/openhands/usage/v0/runtimes/V0_runloop.mdx
similarity index 82%
rename from openhands/usage/runtimes/runloop.mdx
rename to openhands/usage/v0/runtimes/V0_runloop.mdx
index b6c1c4444..9244d06f2 100644
--- a/openhands/usage/runtimes/runloop.mdx
+++ b/openhands/usage/v0/runtimes/V0_runloop.mdx
@@ -1,8 +1,13 @@
 ---
-title: Runloop Runtime
+title: V0_Runloop Runtime
 description: Runloop provides a fast, secure and scalable AI sandbox (Devbox). Check out the
   [runloop docs](https://docs.runloop.ai/overview/what-is-runloop) for more detail.
 ---
+<Note>
+  This page documents **legacy OpenHands V0** behavior. For the current V1
+  sandbox model, see [Sandboxes (V1)](/openhands/usage/sandboxes/overview).
+</Note>
+
 
 ## Access
 Runloop is currently available in a closed beta. For early access, or

From 05e9d512e6cb9b0cddd606acbcfe6c83bacba3b4 Mon Sep 17 00:00:00 2001
From: enyst <engel.nyst@gmail.com>
Date: Mon, 26 Jan 2026 10:39:16 +0000
Subject: [PATCH 02/10] docs: document sandbox provider selection via RUNTIME

Co-authored-by: openhands <openhands@all-hands.dev>
---
 .../usage/advanced/configuration-options.mdx      | 12 ++++++++++++
 openhands/usage/sandboxes/docker.mdx              |  6 ++++++
 openhands/usage/sandboxes/overview.mdx            | 14 ++++++++++++++
 openhands/usage/sandboxes/process.mdx             | 11 ++++++++---
 openhands/usage/sandboxes/remote.mdx              | 15 +++++++++++++++
 5 files changed, 55 insertions(+), 3 deletions(-)

diff --git a/openhands/usage/advanced/configuration-options.mdx b/openhands/usage/advanced/configuration-options.mdx
index c5179f21d..03d51f570 100644
--- a/openhands/usage/advanced/configuration-options.mdx
+++ b/openhands/usage/advanced/configuration-options.mdx
@@ -42,6 +42,18 @@ These are some commonly used variables in V1 deployments:
   - <code>AGENT_SERVER_IMAGE_REPOSITORY</code>
   - <code>AGENT_SERVER_IMAGE_TAG</code>
 
+
+## Sandbox provider selection
+
+Some deployments still use the legacy <code>RUNTIME</code> environment variable to
+choose which sandbox provider to use:
+
+- <code>RUNTIME=docker</code> (default)
+- <code>RUNTIME=process</code> (aka legacy <code>RUNTIME=local</code>)
+- <code>RUNTIME=remote</code>
+
+See [Sandboxes overview](/openhands/usage/sandboxes/overview) for details.
+
 ## Need legacy options?
 
 If you are looking for the old <code>config.toml</code> reference or V0 “runtime”
diff --git a/openhands/usage/sandboxes/docker.mdx b/openhands/usage/sandboxes/docker.mdx
index 4f68738e9..36ad3aa1a 100644
--- a/openhands/usage/sandboxes/docker.mdx
+++ b/openhands/usage/sandboxes/docker.mdx
@@ -6,6 +6,12 @@ description: The recommended sandbox provider for running OpenHands locally.
 The **Docker sandbox** runs the agent server inside a Docker container. This is
 the default and recommended option for most users.
 
+<Note>
+  In some self-hosted deployments, the sandbox provider is controlled via the
+  legacy <code>RUNTIME</code> environment variable. Docker is the default.
+</Note>
+
+
 ## Why Docker?
 
 - Isolation: reduces risk when the agent runs commands.
diff --git a/openhands/usage/sandboxes/overview.mdx b/openhands/usage/sandboxes/overview.mdx
index 82b254bb6..f8c4fe407 100644
--- a/openhands/usage/sandboxes/overview.mdx
+++ b/openhands/usage/sandboxes/overview.mdx
@@ -24,6 +24,20 @@ OpenHands supports multiple sandbox “providers”, with different tradeoffs:
   - Runs the agent server in a remote environment.
   - Used by managed deployments and some hosted setups.
 
+## Selecting a provider (current behavior)
+
+In some deployments, the provider selection is still controlled via the legacy
+<code>RUNTIME</code> environment variable:
+
+- <code>RUNTIME=docker</code> (default)
+- <code>RUNTIME=process</code> (aka legacy <code>RUNTIME=local</code>)
+- <code>RUNTIME=remote</code>
+
+<Note>
+  The user-facing terminology in V1 is <b>sandbox</b>, but the configuration knob
+  may still be called <code>RUNTIME</code> while the migration is in progress.
+</Note>
+
 ## Terminology note (V0 vs V1)
 
 Older documentation refers to these environments as **runtimes**.
diff --git a/openhands/usage/sandboxes/process.mdx b/openhands/usage/sandboxes/process.mdx
index d721aac8d..96f9484ae 100644
--- a/openhands/usage/sandboxes/process.mdx
+++ b/openhands/usage/sandboxes/process.mdx
@@ -23,8 +23,13 @@ regular process.
 
 ## Choosing process mode
 
-Exact configuration depends on how you run OpenHands (CLI launcher, Docker, or
-a self-hosted deployment). In some setups this may still be exposed under a
-legacy “runtime” selector.
+In some deployments, this is selected via the legacy <code>RUNTIME</code>
+environment variable:
+
+```bash
+export RUNTIME=process
+# (legacy alias)
+# export RUNTIME=local
+```
 
 If you are unsure, prefer the [Docker Sandbox](/openhands/usage/sandboxes/docker).
diff --git a/openhands/usage/sandboxes/remote.mdx b/openhands/usage/sandboxes/remote.mdx
index 8e88637e6..68e4fc911 100644
--- a/openhands/usage/sandboxes/remote.mdx
+++ b/openhands/usage/sandboxes/remote.mdx
@@ -9,6 +9,21 @@ instead of on your local machine.
 This is typically used by managed deployments (e.g., OpenHands Cloud) and
 advanced self-hosted setups.
 
+## Selecting remote mode
+
+In some self-hosted deployments, remote sandboxes are selected via the legacy
+<code>RUNTIME</code> environment variable:
+
+```bash
+export RUNTIME=remote
+```
+
+Remote sandboxes require additional configuration (API URL + API key). The exact
+variable names depend on your deployment, but you may see legacy names like:
+
+- <code>SANDBOX_REMOTE_RUNTIME_API_URL</code>
+- <code>SANDBOX_API_KEY</code>
+
 ## Notes
 
 - Remote sandboxes may expose additional service URLs (e.g., VS Code, app ports)

From d4fe002391b0dc73d15bf4723b604872962d9683 Mon Sep 17 00:00:00 2001
From: enyst <engel.nyst@gmail.com>
Date: Mon, 26 Jan 2026 10:47:44 +0000
Subject: [PATCH 03/10] docs: fix sandboxes overview frontmatter

Co-authored-by: openhands <openhands@all-hands.dev>
---
 openhands/usage/sandboxes/overview.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openhands/usage/sandboxes/overview.mdx b/openhands/usage/sandboxes/overview.mdx
index f8c4fe407..d899a168a 100644
--- a/openhands/usage/sandboxes/overview.mdx
+++ b/openhands/usage/sandboxes/overview.mdx
@@ -1,6 +1,6 @@
 ---
 title: Overview
-description: Where OpenHands runs code in V1: Docker sandbox, Process, or Remote.
+description: "Where OpenHands runs code in V1: Docker sandbox, Process, or Remote."
 ---
 
 A **sandbox** is the environment where OpenHands runs commands, edits files, and

From cf6265399570fa09438514f6e7161f01515a7035 Mon Sep 17 00:00:00 2001
From: enyst <engel.nyst@gmail.com>
Date: Mon, 26 Jan 2026 10:52:21 +0000
Subject: [PATCH 04/10] docs: rename Web_V0 tab to Web (V0)

Co-authored-by: openhands <openhands@all-hands.dev>
---
 docs.json                                          | 2 +-
 openhands/usage/advanced/configuration-options.mdx | 6 +++---
 openhands/usage/api/v1.mdx                         | 2 +-
 openhands/usage/sandboxes/overview.mdx             | 2 +-
 4 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs.json b/docs.json
index 4d1cb34c9..37b5ff775 100644
--- a/docs.json
+++ b/docs.json
@@ -171,7 +171,7 @@
         ]
       },
       {
-        "tab": "Web_V0",
+        "tab": "Web (V0)",
         "pages": [
           {
             "group": "V0 REST API",
diff --git a/openhands/usage/advanced/configuration-options.mdx b/openhands/usage/advanced/configuration-options.mdx
index 03d51f570..c1e733535 100644
--- a/openhands/usage/advanced/configuration-options.mdx
+++ b/openhands/usage/advanced/configuration-options.mdx
@@ -7,7 +7,7 @@ description: How to configure OpenHands V1 (Web UI, env vars, and sandbox settin
   This page documents the current <b>V1</b> configuration model.
 
   Legacy <code>config.toml</code> / “runtime” configuration docs have been moved
-  to the <b>Web_V0</b> tab.
+  to the <b>Web (V0)</b> tab.
 </Note>
 
 ## Where configuration lives in V1
@@ -59,5 +59,5 @@ See [Sandboxes overview](/openhands/usage/sandboxes/overview) for details.
 If you are looking for the old <code>config.toml</code> reference or V0 “runtime”
 providers, see:
 
-- <b>Web_V0 → V0 Configuration Options</b>
-- <b>Web_V0 → V0 Runtime Configuration</b>
+- <b>Web (V0) → V0 Configuration Options</b>
+- <b>Web (V0) → V0 Runtime Configuration</b>
diff --git a/openhands/usage/api/v1.mdx b/openhands/usage/api/v1.mdx
index 03f287f20..0a326e895 100644
--- a/openhands/usage/api/v1.mdx
+++ b/openhands/usage/api/v1.mdx
@@ -7,7 +7,7 @@ description: Overview of the current V1 REST endpoints used by the Web app.
   OpenHands is in a transition period: legacy (V0) endpoints still exist alongside
   the new <code>/api/v1</code> endpoints.
 
-  If you need the legacy OpenAPI reference, see the <b>Web_V0</b> tab.
+  If you need the legacy OpenAPI reference, see the <b>Web (V0)</b> tab.
 </Note>
 
 ## Overview
diff --git a/openhands/usage/sandboxes/overview.mdx b/openhands/usage/sandboxes/overview.mdx
index d899a168a..58c70aa1a 100644
--- a/openhands/usage/sandboxes/overview.mdx
+++ b/openhands/usage/sandboxes/overview.mdx
@@ -41,4 +41,4 @@ In some deployments, the provider selection is still controlled via the legacy
 ## Terminology note (V0 vs V1)
 
 Older documentation refers to these environments as **runtimes**.
-Those legacy docs are now in the <b>Web_V0</b> tab.
+Those legacy docs are now in the <b>Web (V0)</b> tab.

From 21c0267477925e7edc1edfc90bd9f7a2dff04564 Mon Sep 17 00:00:00 2001
From: enyst <engel.nyst@gmail.com>
Date: Mon, 26 Jan 2026 10:54:14 +0000
Subject: [PATCH 05/10] docs: rename Process Sandbox page

Co-authored-by: openhands <openhands@all-hands.dev>
---
 openhands/usage/sandboxes/process.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openhands/usage/sandboxes/process.mdx b/openhands/usage/sandboxes/process.mdx
index 96f9484ae..937b7a365 100644
--- a/openhands/usage/sandboxes/process.mdx
+++ b/openhands/usage/sandboxes/process.mdx
@@ -1,5 +1,5 @@
 ---
-title: Process Sandbox (Unsafe)
+title: Process Sandbox
 description: Run the agent server as a local process without container isolation.
 ---
 

From 9bc3f0bffe0b23439b49156a0af6b6b8e05c23d6 Mon Sep 17 00:00:00 2001
From: enyst <engel.nyst@gmail.com>
Date: Mon, 26 Jan 2026 11:09:35 +0000
Subject: [PATCH 06/10] docs: use LLM_API_KEY/LLM_MODEL env vars in V1 config
 page

Co-authored-by: openhands <openhands@all-hands.dev>
---
 openhands/usage/advanced/configuration-options.mdx | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/openhands/usage/advanced/configuration-options.mdx b/openhands/usage/advanced/configuration-options.mdx
index c1e733535..0d1f10c9b 100644
--- a/openhands/usage/advanced/configuration-options.mdx
+++ b/openhands/usage/advanced/configuration-options.mdx
@@ -22,9 +22,9 @@ environment-variable configuration.
 
 These are some commonly used variables in V1 deployments:
 
-- **LLM credentials** (examples)
-  - <code>OPENAI_API_KEY</code>
-  - <code>ANTHROPIC_API_KEY</code>
+- **LLM credentials**
+  - <code>LLM_API_KEY</code>
+  - <code>LLM_MODEL</code>
 
 - **Persistence**
   - <code>OH_PERSISTENCE_DIR</code>: where OpenHands stores local state (defaults to

From 3972bd4d7e18b3676c3282445b7097de07f2c4af Mon Sep 17 00:00:00 2001
From: enyst <engel.nyst@gmail.com>
Date: Mon, 26 Jan 2026 11:11:05 +0000
Subject: [PATCH 07/10] docs: remove V1 API stability note

Co-authored-by: openhands <openhands@all-hands.dev>
---
 openhands/usage/api/v1.mdx | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/openhands/usage/api/v1.mdx b/openhands/usage/api/v1.mdx
index 0a326e895..c5cce55b0 100644
--- a/openhands/usage/api/v1.mdx
+++ b/openhands/usage/api/v1.mdx
@@ -35,8 +35,3 @@ The V1 API is organized around a few core concepts:
 - **Sandbox specs**: list the available sandbox “templates” (e.g., Docker image presets).
   - <code>GET /api/v1/sandbox-specs/search</code>
 
-## Notes on stability
-
-The V1 API surface is still evolving. If you are building something that needs a
-stable contract, consider starting with the legacy (V0) endpoints while we
-finish the V1 migration, and keep an eye on release notes for breaking changes.

From 1dcb5fb262288fc40de9b6494e51915d01645618 Mon Sep 17 00:00:00 2001
From: enyst <engel.nyst@gmail.com>
Date: Mon, 26 Jan 2026 11:38:19 +0000
Subject: [PATCH 08/10] docs: revert OpenHands LLM pricing page

Co-authored-by: openhands <openhands@all-hands.dev>
---
 openhands/usage/llms/openhands-llms.mdx | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/openhands/usage/llms/openhands-llms.mdx b/openhands/usage/llms/openhands-llms.mdx
index bd11071c7..3c1cf9848 100644
--- a/openhands/usage/llms/openhands-llms.mdx
+++ b/openhands/usage/llms/openhands-llms.mdx
@@ -85,16 +85,17 @@ Pricing follows official API provider rates. Below are the current pricing detai
 |-------|----------------------------|-----------------------------------|------------------------------|------------------|-------------------|
 | claude-sonnet-4-5-20250929 | $3.00 | $0.30 | $15.00 | 200,000 | 64,000 |
 | claude-sonnet-4-20250514 | $3.00 | $0.30 | $15.00 | 1,000,000 | 64,000 |
-| claude-opus-4-5-20251101 | $5.00 | $0.50 | $25.00 | 200,000 | 64,000 |
 | claude-opus-4-20250514 | $15.00 | $1.50 | $75.00 | 200,000 | 32,000 |
+| claude-opus-4-1-20250805 | $15.00 | $1.50 | $75.00 | 200,000 | 32,000 |
+| claude-haiku-4-5-20251001 | $1.00 | $0.10 | $5.00 | 200,000 | 64,000 |
+| gpt-5-codex | $1.25 | $0.125 | $10.00 | 272,000 | 128,000 |
 | gpt-5-2025-08-07 | $1.25 | $0.125 | $10.00 | 272,000 | 128,000 |
 | gpt-5-mini-2025-08-07 | $0.25 | $0.025 | $2.00 | 272,000 | 128,000 |
-| gemini-2.5-pro | $1.25 | $0.125 | $10.00 | 1,048,576 | 65,535 |
+| devstral-medium-2507 | $0.40 | N/A | $2.00 | 128,000 | 128,000 |
+| devstral-small-2507 | $0.10 | N/A | $0.30 | 128,000 | 128,000 |
 | o3 | $2.00 | $0.50 | $8.00 | 200,000 | 100,000 |
 | o4-mini | $1.10 | $0.275 | $4.40 | 200,000 | 100,000 |
-| devstral-small-2505 | $0.10 | N/A | $0.30 | 128,000 | 128,000 |
-| devstral-small-2507 | $0.10 | N/A | $0.30 | 128,000 | 128,000 |
-| devstral-medium-2507 | $0.40 | N/A | $2.00 | 128,000 | 128,000 |
+| gemini-3-pro-preview | $2.00 | $0.20 | $12.00 | 1,048,576 | 65,535 |
 | kimi-k2-0711-preview | $0.60 | $0.15 | $2.50 | 131,072 | 131,072 |
 | qwen3-coder-480b | $0.40 | N/A | $1.60 | N/A | N/A |
 

From 94cf5990726cdb2922fc281c0675cffd36678d7f Mon Sep 17 00:00:00 2001
From: enyst <engel.nyst@gmail.com>
Date: Thu, 29 Jan 2026 14:57:26 +0000
Subject: [PATCH 09/10] Adjust V0 tab ordering and titles

Co-authored-by: openhands <openhands@all-hands.dev>
---
 docs.json                                                | 8 ++++----
 openhands/usage/v0/advanced/V0_configuration-options.mdx | 2 +-
 openhands/usage/v0/runtimes/V0_overview.mdx              | 2 +-
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs.json b/docs.json
index f0c27780c..977858db4 100644
--- a/docs.json
+++ b/docs.json
@@ -173,10 +173,6 @@
       {
         "tab": "Web (V0)",
         "pages": [
-          {
-            "group": "V0 REST API",
-            "openapi": "openapi/V0_openapi.json"
-          },
           {
             "group": "V0 Runtime Configuration",
             "pages": [
@@ -205,6 +201,10 @@
             "pages": [
               "openhands/usage/v0/advanced/V0_configuration-options"
             ]
+          },
+          {
+            "group": "V0 REST API",
+            "openapi": "openapi/V0_openapi.json"
           }
         ]
       },
diff --git a/openhands/usage/v0/advanced/V0_configuration-options.mdx b/openhands/usage/v0/advanced/V0_configuration-options.mdx
index 3116a8f64..3a1eedcb5 100644
--- a/openhands/usage/v0/advanced/V0_configuration-options.mdx
+++ b/openhands/usage/v0/advanced/V0_configuration-options.mdx
@@ -1,5 +1,5 @@
 ---
-title: V0_Configuration Options
+title: Configuration Options
 description: This page outlines all available configuration options for OpenHands, allowing you to customize its
   behavior and integrate it with other services.
 ---
diff --git a/openhands/usage/v0/runtimes/V0_overview.mdx b/openhands/usage/v0/runtimes/V0_overview.mdx
index d11244a81..49ed08c39 100644
--- a/openhands/usage/v0/runtimes/V0_overview.mdx
+++ b/openhands/usage/v0/runtimes/V0_overview.mdx
@@ -1,5 +1,5 @@
 ---
-title: V0_Overview
+title: Overview
 description: This section is for users that would like to use a runtime other than Docker for OpenHands.
 ---
 <Note>

From 79f447bb265511a792dbadcc465457369a7b340c Mon Sep 17 00:00:00 2001
From: enyst <engel.nyst@gmail.com>
Date: Thu, 29 Jan 2026 15:05:40 +0000
Subject: [PATCH 10/10] Remove V0 prefix from runtime titles

Co-authored-by: openhands <openhands@all-hands.dev>
---
 openhands/usage/v0/runtimes/V0_daytona.mdx | 2 +-
 openhands/usage/v0/runtimes/V0_docker.mdx  | 2 +-
 openhands/usage/v0/runtimes/V0_e2b.mdx     | 2 +-
 openhands/usage/v0/runtimes/V0_local.mdx   | 2 +-
 openhands/usage/v0/runtimes/V0_modal.mdx   | 2 +-
 openhands/usage/v0/runtimes/V0_remote.mdx  | 2 +-
 openhands/usage/v0/runtimes/V0_runloop.mdx | 2 +-
 7 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/openhands/usage/v0/runtimes/V0_daytona.mdx b/openhands/usage/v0/runtimes/V0_daytona.mdx
index 080c41a45..8c457279d 100644
--- a/openhands/usage/v0/runtimes/V0_daytona.mdx
+++ b/openhands/usage/v0/runtimes/V0_daytona.mdx
@@ -1,5 +1,5 @@
 ---
-title: V0_Daytona Runtime
+title: Daytona Runtime
 description: You can use [Daytona](https://www.daytona.io/) as a runtime provider.
 ---
 <Note>
diff --git a/openhands/usage/v0/runtimes/V0_docker.mdx b/openhands/usage/v0/runtimes/V0_docker.mdx
index 8fa13b529..f1bc93d65 100644
--- a/openhands/usage/v0/runtimes/V0_docker.mdx
+++ b/openhands/usage/v0/runtimes/V0_docker.mdx
@@ -1,5 +1,5 @@
 ---
-title: V0_Docker Runtime
+title: Docker Runtime
 description: This is the default Runtime that's used when you start OpenHands.
 ---
 <Note>
diff --git a/openhands/usage/v0/runtimes/V0_e2b.mdx b/openhands/usage/v0/runtimes/V0_e2b.mdx
index 6278337a8..8a9014d00 100644
--- a/openhands/usage/v0/runtimes/V0_e2b.mdx
+++ b/openhands/usage/v0/runtimes/V0_e2b.mdx
@@ -1,5 +1,5 @@
 ---
-title: V0_E2B Runtime
+title: E2B Runtime
 description: E2B is an open-source secure cloud environment (sandbox) made for running AI-generated code and agents.
 ---
 <Note>
diff --git a/openhands/usage/v0/runtimes/V0_local.mdx b/openhands/usage/v0/runtimes/V0_local.mdx
index 07c89a3fa..2690c83e1 100644
--- a/openhands/usage/v0/runtimes/V0_local.mdx
+++ b/openhands/usage/v0/runtimes/V0_local.mdx
@@ -1,5 +1,5 @@
 ---
-title: V0_Local Runtime
+title: Local Runtime
 description: The Local Runtime allows the OpenHands agent to execute actions directly on your local machine without
   using Docker. This runtime is primarily intended for controlled environments like CI pipelines or testing scenarios
   where Docker is not available.
diff --git a/openhands/usage/v0/runtimes/V0_modal.mdx b/openhands/usage/v0/runtimes/V0_modal.mdx
index d201a0b2b..3d69cf1e7 100644
--- a/openhands/usage/v0/runtimes/V0_modal.mdx
+++ b/openhands/usage/v0/runtimes/V0_modal.mdx
@@ -1,5 +1,5 @@
 ---
-title: V0_Modal Runtime
+title: Modal Runtime
 ---
 <Note>
   This page documents **legacy OpenHands V0** behavior. For the current V1
diff --git a/openhands/usage/v0/runtimes/V0_remote.mdx b/openhands/usage/v0/runtimes/V0_remote.mdx
index 4e9ed7c34..8db86b010 100644
--- a/openhands/usage/v0/runtimes/V0_remote.mdx
+++ b/openhands/usage/v0/runtimes/V0_remote.mdx
@@ -1,5 +1,5 @@
 ---
-title: V0_Remote Runtime
+title: Remote Runtime
 description: This runtime is specifically designed for agent evaluation purposes only through the
   [OpenHands evaluation harness](https://github.com/OpenHands/OpenHands/tree/main/evaluation). It should not be
   used to launch production OpenHands applications.
diff --git a/openhands/usage/v0/runtimes/V0_runloop.mdx b/openhands/usage/v0/runtimes/V0_runloop.mdx
index 9244d06f2..30e30d1ae 100644
--- a/openhands/usage/v0/runtimes/V0_runloop.mdx
+++ b/openhands/usage/v0/runtimes/V0_runloop.mdx
@@ -1,5 +1,5 @@
 ---
-title: V0_Runloop Runtime
+title: Runloop Runtime
 description: Runloop provides a fast, secure and scalable AI sandbox (Devbox). Check out the
   [runloop docs](https://docs.runloop.ai/overview/what-is-runloop) for more detail.
 ---