From 3aa39ad76f3cb2ba8a84a6f4dcc8058b0ecf7962 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Da=CC=81vid=20Istva=CC=81n=20Bi=CC=81ro=CC=81?= Date: Sun, 22 Mar 2026 14:00:31 +0100 Subject: [PATCH 1/2] add doc about Golem CLI HTTP timeouts --- src/pages/cli/_meta.json | 3 +- src/pages/cli/http-timeouts.mdx | 54 +++++++++++++++++++++++++++++++++ 2 files changed, 56 insertions(+), 1 deletion(-) create mode 100644 src/pages/cli/http-timeouts.mdx diff --git a/src/pages/cli/_meta.json b/src/pages/cli/_meta.json index d80116b..13ce19a 100644 --- a/src/pages/cli/_meta.json +++ b/src/pages/cli/_meta.json @@ -6,5 +6,6 @@ "permissions": "Permissions", "plugins": "Plugins", "shell-completion": "Shell Completion", - "install-from-source": "Install from Source" + "install-from-source": "Install from Source", + "http-timeouts": "HTTP Timeouts" } diff --git a/src/pages/cli/http-timeouts.mdx b/src/pages/cli/http-timeouts.mdx new file mode 100644 index 0000000..45e0cb4 --- /dev/null +++ b/src/pages/cli/http-timeouts.mdx @@ -0,0 +1,54 @@ +# Golem CLI HTTP Timeouts + +Golem CLI HTTP timeout behavior can be configured with environment variables. + +Durations use ISO-8601 format, for example `PT10S`, `PT1M`, or `PT2M30S`. + +## Service HTTP requests + +Used for general service API calls, including login and deploy-related calls. + +| Environment variable | Controls | Fallback default | +| --- | --- | --- | +| `GOLEM_HTTP_TIMEOUT` | Total request timeout | `PT60S` | +| `GOLEM_HTTP_CONNECT_TIMEOUT` | Connection setup timeout | `PT10S` | +| `GOLEM_HTTP_READ_TIMEOUT` | Response read timeout | `PT60S` | + +## Invoke requests + +Used for agent invocation HTTP requests. + +| Environment variable | Controls | Fallback default | +| --- | --- | --- | +| `GOLEM_HTTP_INVOKE_TIMEOUT` | Total request timeout | `none` | +| `GOLEM_HTTP_INVOKE_CONNECT_TIMEOUT` | Connection setup timeout | `none` | +| `GOLEM_HTTP_INVOKE_READ_TIMEOUT` | Response read timeout | `none` | + +## Health check requests + +Used for health-check HTTP requests. + +| Environment variable | Controls | Fallback default | +| --- | --- | --- | +| `GOLEM_HTTP_HEALTHCHECK_TIMEOUT` | Total request timeout | `PT2S` | +| `GOLEM_HTTP_HEALTHCHECK_CONNECT_TIMEOUT` | Connection setup timeout | `PT1S` | +| `GOLEM_HTTP_HEALTHCHECK_READ_TIMEOUT` | Response read timeout | `PT1S` | + +## File download requests + +Used for file downloads in app/manifest-related flows. + +| Environment variable | Controls | Fallback default | +| --- | --- | --- | +| `GOLEM_HTTP_FILE_DOWNLOAD_TIMEOUT` | Total request timeout | `PT60S` | +| `GOLEM_HTTP_FILE_DOWNLOAD_CONNECT_TIMEOUT` | Connection setup timeout | `PT10S` | +| `GOLEM_HTTP_FILE_DOWNLOAD_READ_TIMEOUT` | Response read timeout | `PT60S` | + +## Example + +```shell copy +export GOLEM_HTTP_TIMEOUT=PT90S +export GOLEM_HTTP_CONNECT_TIMEOUT=PT10S +export GOLEM_HTTP_READ_TIMEOUT=PT90S +golem deploy +``` From a06f7ebefe84538361242ae6469599e9f5f184f8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Da=CC=81vid=20Istva=CC=81n=20Bi=CC=81ro=CC=81?= Date: Sun, 22 Mar 2026 14:58:19 +0100 Subject: [PATCH 2/2] update to latest values --- src/pages/cli/http-timeouts.mdx | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/src/pages/cli/http-timeouts.mdx b/src/pages/cli/http-timeouts.mdx index 45e0cb4..943fbab 100644 --- a/src/pages/cli/http-timeouts.mdx +++ b/src/pages/cli/http-timeouts.mdx @@ -10,7 +10,7 @@ Used for general service API calls, including login and deploy-related calls. | Environment variable | Controls | Fallback default | | --- | --- | --- | -| `GOLEM_HTTP_TIMEOUT` | Total request timeout | `PT60S` | +| `GOLEM_HTTP_TIMEOUT` | Total request timeout | `PT120S` | | `GOLEM_HTTP_CONNECT_TIMEOUT` | Connection setup timeout | `PT10S` | | `GOLEM_HTTP_READ_TIMEOUT` | Response read timeout | `PT60S` | @@ -20,9 +20,9 @@ Used for agent invocation HTTP requests. | Environment variable | Controls | Fallback default | | --- | --- | --- | -| `GOLEM_HTTP_INVOKE_TIMEOUT` | Total request timeout | `none` | -| `GOLEM_HTTP_INVOKE_CONNECT_TIMEOUT` | Connection setup timeout | `none` | -| `GOLEM_HTTP_INVOKE_READ_TIMEOUT` | Response read timeout | `none` | +| `GOLEM_HTTP_INVOKE_TIMEOUT` | Total request timeout | `none (unbounded)` | +| `GOLEM_HTTP_INVOKE_CONNECT_TIMEOUT` | Connection setup timeout | `none (unbounded)` | +| `GOLEM_HTTP_INVOKE_READ_TIMEOUT` | Response read timeout | `none (unbounded)` | ## Health check requests @@ -40,15 +40,15 @@ Used for file downloads in app/manifest-related flows. | Environment variable | Controls | Fallback default | | --- | --- | --- | -| `GOLEM_HTTP_FILE_DOWNLOAD_TIMEOUT` | Total request timeout | `PT60S` | +| `GOLEM_HTTP_FILE_DOWNLOAD_TIMEOUT` | Total request timeout | `PT120S` | | `GOLEM_HTTP_FILE_DOWNLOAD_CONNECT_TIMEOUT` | Connection setup timeout | `PT10S` | | `GOLEM_HTTP_FILE_DOWNLOAD_READ_TIMEOUT` | Response read timeout | `PT60S` | ## Example ```shell copy -export GOLEM_HTTP_TIMEOUT=PT90S +export GOLEM_HTTP_TIMEOUT=PT120S export GOLEM_HTTP_CONNECT_TIMEOUT=PT10S -export GOLEM_HTTP_READ_TIMEOUT=PT90S +export GOLEM_HTTP_READ_TIMEOUT=PT120S golem deploy ```