---
title: "BashServerToolConfig"
---

Configuration for the openrouter:bash server tool


## Fields

| Field                                                                                                                                                                                                                                                       | Type                                                                                                                                                                                                                                                        | Required                                                                                                                                                                                                                                                    | Description                                                                                                                                                                                                                                                 | Example                                                                                                                                                                                                                                                     |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `engine`                                                                                                                                                                                                                                                    | [Optional[components.BashServerToolEngine]](../components/bashservertoolengine.mdx)                                                                                                                                                                          | :heavy_minus_sign:                                                                                                                                                                                                                                          | Which bash engine to use. "openrouter" runs commands server-side in the OpenRouter sandbox. "auto" (default) and "native" use native passthrough, returning the tool call to your application to run client-side; OpenRouter does not execute the commands. | auto                                                                                                                                                                                                                                                        |
| `environment`                                                                                                                                                                                                                                               | [Optional[components.BashServerToolEnvironment]](../components/bashservertoolenvironment.mdx)                                                                                                                                                                | :heavy_minus_sign:                                                                                                                                                                                                                                          | Execution environment for the bash server tool.                                                                                                                                                                                                             | \{<br/>"type": "container_auto"<br/>}                                                                                                                                                                                                                        |
| `sleep_after_seconds`                                                                                                                                                                                                                                       | *Optional[int]*                                                                                                                                                                                                                                             | :heavy_minus_sign:                                                                                                                                                                                                                                          | How long (in seconds) the container stays warm after its last command before sleeping, freeing its capacity slot. Idle-based: each command renews the timer. Defaults to 900 (15 minutes); capped at 2592000 (30 days).                                     | 900                                                                                                                                                                                                                                                         |