From 0a3416a534826a3eb5c2754a389ad28ab2656437 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Sat, 9 May 2026 13:29:28 +0000
Subject: [PATCH] Document 15-minute per-agent-group image build timeout

Generated-By: mintlify-agent
---
 advanced/container-runtime.mdx | 1 +
 concepts/containers.mdx        | 1 +
 2 files changed, 2 insertions(+)

diff --git a/advanced/container-runtime.mdx b/advanced/container-runtime.mdx
index 045e018..bb46966 100644
--- a/advanced/container-runtime.mdx
+++ b/advanced/container-runtime.mdx
@@ -82,6 +82,7 @@ Agent groups can specify custom packages in `container.json`. The host builds a
 - Tag: derived from the checkout-scoped base image and agent group
 - Built on top of `nanoclaw-agent-v2-<slug>:latest`
 - Adds custom apt and npm packages
+- Build timeout: 15 minutes (accommodates large apt/npm package installs on slow networks)
 
 ## Two-database IO model
 
diff --git a/concepts/containers.mdx b/concepts/containers.mdx
index c328ee0..03c3280 100644
--- a/concepts/containers.mdx
+++ b/concepts/containers.mdx
@@ -154,6 +154,7 @@ Agent groups can specify custom packages in `container.json`. The host builds a
 - Image tag: derived from the checkout-scoped base image and agent group
 - Built on top of the base `nanoclaw-agent-v2-<slug>:latest` image
 - Cached — only rebuilt when package lists change
+- Image build is bounded by a 15-minute timeout to allow for large package installs
 
 ## Timeouts