buildx_use
Select the active Docker builder for buildx operations. Persist the choice as default for the current context or globally to control which builder subsequent builds use.
Instructions
Select the active builder for subsequent buildx operations.
Without default or global_default the switch applies only to the current CLI
session. default persists the choice for the current Docker context; global_default
persists across all Docker contexts. Use buildx_list to see available builders and their
current status. To avoid switching the global default, pass a specific builder name
directly via buildx_build's builder parameter instead.
Does not raise on a non-zero CLI exit (a missing buildx plugin or a timeout still raises) - inspect
returncode/stderr in the result.
Args:
name: Builder name to activate (from buildx_list)
default: Persist as default builder for the current Docker context
global_default: Persist as default builder across all Docker contexts
Returns: dict: {"returncode": int, "stdout": str, "stderr": str, "truncated": bool}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| default | No | ||
| global_default | No |