| 1 | # Docker Base Image DOX |
| 2 | |
| 3 | ## Purpose |
| 4 | |
| 5 | - Own the Agent Zero base image build context. |
| 6 | - Build the operating system, package, Python, SearXNG, SSH, and bootstrap layers reused by runnable images. |
| 7 | |
| 8 | ## Ownership |
| 9 | |
| 10 | - `Dockerfile` owns base image layering and installation order. |
| 11 | - `build.txt` owns maintainer build and push command notes. |
| 12 | - `fs/ins/` owns installation scripts copied into the image. |
| 13 | - Files under `fs/` are copied to container root during the base build. |
| 14 | |
| 15 | ## Local Contracts |
| 16 | |
| 17 | - Preserve cache-friendly package and runtime installation stages. |
| 18 | - Keep locale and timezone defaults compatible with the root Docker contract. |
| 19 | - Do not add secrets, user data, or local environment files to the image context. |
| 20 | - Installation scripts must be noninteractive and suitable for multi-architecture buildx runs. |
| 21 | |
| 22 | ## Work Guidance |
| 23 | |
| 24 | - Keep base dependencies here only when they are common to runnable Agent Zero images. |
| 25 | - Coordinate Python runtime changes with root Docker documentation and runnable image setup. |
| 26 | |
| 27 | ## Verification |
| 28 | |
| 29 | - Build `docker/base` when changing Dockerfile or install scripts. |
| 30 | - Run a runnable image smoke check when base runtime behavior changes. |
| 31 | |
| 32 | ## Child DOX Index |
| 33 | |
| 34 | No child DOX files. |