$ export BUILDKIT_HOST=tcp://localhost:1234
$ docker buildx create --name=remote --driver=remote
```
If you specify both the `BUILDKIT_HOST` environment variable and a positional
argument, the argument takes priority.
### BUILDKIT_PROGRESS
Sets the type of the BuildKit progress output. Valid values are:
- `auto` (default)
- `plain`
- `tty`
- `quiet`
- `rawjson`
Usage:
```console
$ export BUILDKIT_PROGRESS=plain
```
### BUILDKIT_TTY_LOG_LINES
You can change how many log lines are visible for active steps in TTY mode by
setting `BUILDKIT_TTY_LOG_LINES` to a number (default to `6`).
```console
$ export BUILDKIT_TTY_LOG_LINES=8
```
### EXPERIMENTAL_BUILDKIT_SOURCE_POLICY
Lets you specify a
[BuildKit source policy](https://github.com/moby/buildkit/blob/master/docs/build-repro.md#reproducing-the-pinned-dependencies)
file for creating reproducible builds with pinned dependencies.
```console
$ export EXPERIMENTAL_BUILDKIT_SOURCE_POLICY=./policy.json
```
Example:
```json
{
"rules": [
{
"action": "CONVERT",
"selector": {
"identifier": "docker-image://docker.io/library/alpine:latest"
},
"updates": {
"identifier": "docker-image://docker.io/library/alpine:latest@sha256:4edbd2beb5f78b1014028f4fbb99f3237d9561100b6881aabbf5acce2c4f9454"
}
},
{
"action": "CONVERT",
"selector": {
"identifier": "https://raw.githubusercontent.com/moby/buildkit/v0.10.1/README.md"
},
"updates": {
"attrs": {"http.checksum": "sha256:6e4b94fc270e708e1068be28bd3551dc6917a4fc5a61293d51bb36e6b75c4b53"}
}
},
{
"action": "DENY",
"selector": {
"identifier": "docker-image://docker.io/library/golang*"
}
}
]
}
```
### BUILDX_BAKE_GIT_AUTH_HEADER
{{< summary-bar feature_name="Buildx bake Git auth token" >}}
Sets the HTTP authentication scheme when using a remote Bake definition in a private Git repository.
This is equivalent to the [`GIT_AUTH_HEADER` secret](./secrets#http-authentication-scheme),
but facilitates the pre-flight authentication in Bake when loading the remote Bake file.
Supported values are `bearer` (default) and `basic`.
Usage:
```console
$ export BUILDX_BAKE_GIT_AUTH_HEADER=basic
```
### BUILDX_BAKE_GIT_AUTH_TOKEN
{{< summary-bar feature_name="Buildx bake Git auth token" >}}
Sets the HTTP authentication token when using a remote Bake definition in a private Git repository.
This is equivalent to the [`GIT_AUTH_TOKEN` secret](./secrets#git-authentication-for-remote-contexts),
but facilitates the pre-flight authentication in Bake when loading the remote Bake file.
Usage:
```console
$ export BUILDX_BAKE_GIT_AUTH_TOKEN=$(cat git-token.txt)
```
### BUILDX_BAKE_GIT_SSH
{{< summary-bar feature_name="Buildx bake Git SSH" >}}
Lets you specify a list of SSH agent socket filepaths to forward to Bake
for authenticating to a Git server when using a remote Bake definition in a private repository.
This is similar to SSH mounts for builds, but facilitates the pre-flight authentication in Bake when resolving the build definition.
Setting this environment is typically not necessary, because Bake will use the `SSH_AUTH_SOCK` agent socket by default.
You only need to specify this variable if you want to use a socket with a different filepath.
This variable can take multiple paths using a comma-separated string.
Usage:
```console
$ export BUILDX_BAKE_GIT_SSH=/run/foo/listener.sock,~/.creds/ssh.sock
```
### BUILDX_BUILDER
Overrides the configured builder instance. Same as the `docker buildx --builder`
CLI flag.
Usage:
```console
$ export BUILDX_BUILDER=my-builder
```
### BUILDX_CONFIG
You can use `BUILDX_CONFIG` to specify the directory to use for build
configuration, state, and logs. The lookup order for this directory is as
follows:
- `$BUILDX_CONFIG`
- `$DOCKER_CONFIG/buildx`
- `~/.docker/buildx` (default)
Usage:
```console
$ export BUILDX_CONFIG=/usr/local/etc