Scroll to navigation

DOCKER-BUILDX-HISTORY-LS(1) DOCKER-BUILDX-HISTORY-LS(1)

NAME

docker-buildx-history-ls - List build records

SYNOPSIS

docker buildx history ls [OPTIONS]

DESCRIPTION

List completed builds recorded by the active builder. Each entry includes the build ID, name, status, timestamp, and duration.

By default, only records for the current builder are shown. You can filter results using flags.

OPTIONS

--filter=[] Provide filter values (e.g., "status=error")

--format="table" Format the output

-h, --help[=false] help for ls

--local[=false] List records for current repository only

--no-trunc[=false] Don't truncate output

OPTIONS INHERITED FROM PARENT COMMANDS

--builder="" Override the configured builder instance

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

EXAMPLE

### List all build records for the current builder
```console
$ docker buildx history ls
BUILD ID                    NAME           STATUS     CREATED AT        DURATION
qu2gsuo8ejqrwdfii23xkkckt   .dev/2850      Completed  3 days ago        1.4s
qsiifiuf1ad9pa9qvppc0z1l3   .dev/2850      Completed  3 days ago        1.3s
g9808bwrjrlkbhdamxklx660b   .dev/3120      Completed  5 days ago        2.1s

List failed builds (--filter) {#filter}

docker buildx history ls --filter status=error

You can filter the list using the --filter flag. Supported filters include:

Filter Supported comparisons Example
ref, repository, status Support = and != comparisons --filter status!=success
startedAt, completedAt, duration Support < and > comparisons with time values --filter duration>30s

You can combine multiple filters by repeating the --filter flag:

docker buildx history ls --filter status=error --filter duration>30s

List builds from the current project (--local) {#local}

docker buildx history ls --local

Display full output without truncation (--no-trunc) {#no-trunc}

docker buildx history ls --no-trunc

Format output (--format) {#format}

JSON output

$ docker buildx history ls --format json
[


  {


    "ID": "qu2gsuo8ejqrwdfii23xkkckt",


    "Name": ".dev/2850",


    "Status": "Completed",


    "CreatedAt": "2025-04-15T12:33:00Z",


    "Duration": "1.4s"


  },


  {


    "ID": "qsiifiuf1ad9pa9qvppc0z1l3",


    "Name": ".dev/2850",


    "Status": "Completed",


    "CreatedAt": "2025-04-15T12:29:00Z",


    "Duration": "1.3s"


  }
]

Go template output

$ docker buildx history ls --format '{{.Name}} - {{.Duration}}'
.dev/2850 - 1.4s
.dev/2850 - 1.3s
.dev/3120 - 2.1s

```

SEE ALSO

docker-buildx-history(1)

Mar 2026