From 8bcf041190e9fe88ed790d9d1467d77120b2f40d Mon Sep 17 00:00:00 2001 From: rishabh Date: Sun, 15 Mar 2026 22:32:28 +0800 Subject: [PATCH] docs: clarify Bake environment variable override behavior Signed-off-by: rishabh docs: address review feedback on bake env lookup Signed-off-by: rishabh --- docs/bake-reference.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/docs/bake-reference.md b/docs/bake-reference.md index 2043f6f1b923..a4f236fa5299 100644 --- a/docs/bake-reference.md +++ b/docs/bake-reference.md @@ -1350,11 +1350,17 @@ to define them. ### Use environment variable as default -You can set a Bake variable to use the value of an environment variable as a default value: +If an environment variable exists with the same name as a declared Bake +variable, Bake uses that environment variable value instead of the declared +default. + +To disable this environment-based variable lookup, set +`BUILDX_BAKE_DISABLE_VARS_ENV_LOOKUP=1`. + ```hcl variable "HOME" { - default = "$HOME" + default = "/root" } ```