From f139a9970be2fe1000185d53ac3216d74d6869ef Mon Sep 17 00:00:00 2001 From: Xingyao Wang Date: Sat, 7 Feb 2026 06:12:29 +0800 Subject: [PATCH] feat: add SANDBOX_STARTUP_GRACE_SECONDS env var for configurable startup timeout (#12741) Co-authored-by: openhands --- openhands/app_server/config.py | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/openhands/app_server/config.py b/openhands/app_server/config.py index 2aec996cd6..0cc42a471a 100644 --- a/openhands/app_server/config.py +++ b/openhands/app_server/config.py @@ -205,6 +205,13 @@ def config_from_env() -> AppServerConfig: docker_sandbox_kwargs['container_url_pattern'] = os.environ[ 'SANDBOX_CONTAINER_URL_PATTERN' ] + # Allow configuring sandbox startup grace period + # This is useful for slower machines or cloud environments where + # the agent-server container takes longer to initialize + if os.getenv('SANDBOX_STARTUP_GRACE_SECONDS'): + docker_sandbox_kwargs['startup_grace_seconds'] = int( + os.environ['SANDBOX_STARTUP_GRACE_SECONDS'] + ) # Parse SANDBOX_VOLUMES and convert to VolumeMount objects # This is set by the CLI's --mount-cwd flag sandbox_volumes = os.getenv('SANDBOX_VOLUMES')