From f618da15d69e87d2e4e97873825aa1cbbfa5ace8 Mon Sep 17 00:00:00 2001 From: Chris Williams Date: Wed, 25 Mar 2026 11:03:50 -0700 Subject: [PATCH] Add note about root privileges in sandbox docs (#23314) --- docs/reference/configuration.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/reference/configuration.md b/docs/reference/configuration.md index 8b38dc1aff..869b8a0e21 100644 --- a/docs/reference/configuration.md +++ b/docs/reference/configuration.md @@ -2352,9 +2352,13 @@ can be based on the base sandbox image: ```dockerfile FROM gemini-cli-sandbox -# Add your custom dependencies or configurations here +# Add your custom dependencies or configurations here. +# Note: The base image runs as the non-root 'node' user. +# You must switch to 'root' to install system packages. # For example: +# USER root # RUN apt-get update && apt-get install -y some-package +# USER node # COPY ./my-config /app/my-config ```