Scroll to navigation

DOCKER-BUILDX-DIAL-STDIO(1) DOCKER-BUILDX-DIAL-STDIO(1)

NAME

docker-buildx-dial-stdio - Proxy current stdio streams to builder instance

SYNOPSIS

docker buildx dial-stdio

DESCRIPTION

dial-stdio uses the stdin and stdout streams of the command to proxy to the configured builder instance. It is not intended to be used by humans, but rather by other tools that want to interact with the builder instance via BuildKit API.

OPTIONS

-h, --help[=false] help for dial-stdio

--platform="" Target platform: this is used for node selection

--progress="quiet" Set type of progress output ("auto", "plain", "tty", "rawjson"). Use plain to show container output

OPTIONS INHERITED FROM PARENT COMMANDS

--builder="" Override the configured builder instance

-D, --debug[=false] Enable debug logging

EXAMPLE

Example go program that uses the dial-stdio command wire up a buildkit client.
This is for example use only and may not be suitable for production use.
```go
client.New(ctx, "", client.WithContextDialer(func(context.Context, string) (net.Conn, error) {

c1, c2 := net.Pipe()
cmd := exec.Command("docker", "buildx", "dial-stdio")
cmd.Stdin = c1
cmd.Stdout = c1
if err := cmd.Start(); err != nil {
c1.Close()
c2.Close()
return nil, err
}
go func() {
cmd.Wait()
c2.Close()
}()
return c2 }))

```

SEE ALSO

docker-buildx(1)

Oct 2025