Extend self-update health timeout
Raise the default update and rollback health-check window from two to three minutes so slower Docker and virtiofs installations can finish booting. Preserve the existing environment override and document the runtime default.
Alessandro committed
Jul 10, 2026 at 19:07 UTC
4e8301899e50053aa218a21217a22461a93ec40d
2 files changed
+2
-1
docker/run/AGENTS.md
+1
@@ -23,6 +23,7 @@
23
- Runtime startup must ensure `/a0/usr/uploads` exists before supervised services start.
24
- Runtime startup raises the soft open-file limit toward `A0_NOFILE_LIMIT` (default `65535`) before supervisord starts, bounded by the container hard limit.
25
- Self-update user-data backups skip Time Travel shadow history under `usr/.time_travel/` and transient Desktop agent state.
26
+- Self-update waits up to 180 seconds for the updated or restored WebUI health check by default; `A0_SELF_UPDATE_HEALTH_TIMEOUT_SECONDS` may override it.
27
- Successful or already-current self-updates refresh an installed Codex CLI with npm on a best-effort basis; missing CLIs and registry failures must not block Agent Zero startup.
28
29
## Work Guidance
docker/run/fs/exe/self_update_manager.py
+1
-1
@@ -36,7 +36,7 @@ DEFAULT_HEALTH_URL = os.environ.get(
36
"http://127.0.0.1:80/api/health",
37
)
38
DEFAULT_HEALTH_TIMEOUT_SECONDS = int(
39
- os.environ.get("A0_SELF_UPDATE_HEALTH_TIMEOUT_SECONDS", "120")
39
+ os.environ.get("A0_SELF_UPDATE_HEALTH_TIMEOUT_SECONDS", "180")
40
)
41
DEFAULT_HEALTH_POLL_INTERVAL_SECONDS = float(
42
os.environ.get("A0_SELF_UPDATE_HEALTH_POLL_INTERVAL_SECONDS", "2")