github.com/pdmccormick/importable-docker-buildx@v0.0.0-20240426161518-e47091289030/docs/reference/buildx_du.md (about)

     1  # buildx du
     2  
     3  ```text
     4  docker buildx du
     5  ```
     6  
     7  <!---MARKER_GEN_START-->
     8  Disk usage
     9  
    10  ### Options
    11  
    12  | Name                    | Type     | Default | Description                              |
    13  |:------------------------|:---------|:--------|:-----------------------------------------|
    14  | [`--builder`](#builder) | `string` |         | Override the configured builder instance |
    15  | `--filter`              | `filter` |         | Provide filter values                    |
    16  | [`--verbose`](#verbose) |          |         | Provide a more verbose output            |
    17  
    18  
    19  <!---MARKER_GEN_END-->
    20  
    21  ## Examples
    22  
    23  ### Show disk usage
    24  
    25  The `docker buildx du` command shows the disk usage for the currently selected
    26  builder.
    27  
    28  ```console
    29  $ docker buildx du
    30  ID                                RECLAIMABLE    SIZE          LAST ACCESSED
    31  12wgll9os87pazzft8lt0yztp*        true           1.704GB       13 days ago
    32  iupsv3it5ubh92aweb7c1wojc*        true           1.297GB       36 minutes ago
    33  ek4ve8h4obyv5kld6vicmtqyn         true           811.7MB       13 days ago
    34  isovrfnmkelzhtdx942w9vjcb*        true           811.7MB       13 days ago
    35  0jty7mjrndi1yo7xkv1baralh         true           810.5MB       13 days ago
    36  jyzkefmsysqiaakgwmjgxjpcz*        true           810.5MB       13 days ago
    37  z8w1y95jn93gvj92jtaj6uhwk         true           318MB         2 weeks ago
    38  rz2zgfcwlfxsxd7d41w2sz2tt         true           8.224kB*      43 hours ago
    39  n5bkzpewmk2eiu6hn9tzx18jd         true           8.224kB*      43 hours ago
    40  ao94g6vtbzdl6k5zgdmrmnwpt         true           8.224kB*      43 hours ago
    41  2pyjep7njm0wh39vcingxb97i         true           8.224kB*      43 hours ago
    42  Shared:        115.5MB
    43  Private:       10.25GB
    44  Reclaimable:   10.36GB
    45  Total:         10.36GB
    46  ```
    47  
    48  If `RECLAIMABLE` is false, the `docker buildx du prune` command won't delete
    49  the record, even if you use `--all`. That's because the record is actively in
    50  use by some component of the builder.
    51  
    52  The asterisks (\*) in the default output indicate the following:
    53  
    54  - An asterisk next to an ID (`zu7m6evdpebh5h8kfkpw9dlf2*`) indicates that the record
    55    is mutable. The size of the record may change, or another build can take ownership of
    56    it and change or commit to it. If you run the `du` command again, this item may
    57    not be there anymore, or the size might be different.
    58  - An asterisk next to a size (`8.288kB*`) indicates that the record is shared.
    59    Storage of the record is shared with some other resource, typically an image.
    60    If you prune such a record then you will lose build cache but only metadata
    61    will be deleted as the image still needs to actual storage layers.
    62  
    63  ### <a name="verbose"></a> Use verbose output (--verbose)
    64  
    65  The verbose output of the `docker buildx du` command is useful for inspecting
    66  the disk usage records in more detail. The verbose output shows the mutable and
    67  shared states more clearly, as well as additional information about the
    68  corresponding layer.
    69  
    70  ```console
    71  $ docker buildx du --verbose
    72  ...
    73  Last used:      2 days ago
    74  Type:           regular
    75  
    76  ID:             05d0elirb4mmvpmnzbrp3ssrg
    77  Parent:         e8sfdn4mygrg7msi9ak1dy6op
    78  Created at:     2023-11-20 09:53:30.881558721 +0000 UTC
    79  Mutable:        false
    80  Reclaimable:    true
    81  Shared:         false
    82  Size:           0B
    83  Description:    [gobase 3/3] WORKDIR /src
    84  Usage count:    3
    85  Last used:      24 hours ago
    86  Type:           regular
    87  
    88  Reclaimable:    4.453GB
    89  Total:          4.453GB
    90  ```
    91  
    92  ### <a name="builder"></a> Override the configured builder instance (--builder)
    93  
    94  Use the `--builder` flag to inspect the disk usage of a particular builder.
    95  
    96  ```console
    97  $ docker buildx du --builder youthful_shtern
    98  ID                                RECLAIMABLE    SIZE          LAST ACCESSED
    99  g41agepgdczekxg2mtw0dujsv*        true           1.312GB       47 hours ago
   100  e6ycrsa0bn9akigqgzu0sc6kr         true           318MB         47 hours ago
   101  our9zg4ndly65ze1ccczdksiz         true           204.9MB       45 hours ago
   102  b7xv3xpxnwupc81tc9ya3mgq6*        true           120.6MB       47 hours ago
   103  zihgye15ss6vum3wmck9egdoy*        true           79.81MB       2 days ago
   104  aaydharssv1ug98yhuwclkfrh*        true           79.81MB       2 days ago
   105  ta1r4vmnjug5dhub76as4kkol*        true           74.51MB       47 hours ago
   106  murma9f83j9h8miifbq68udjf*        true           74.51MB       47 hours ago
   107  47f961866a49g5y8myz80ixw1*        true           74.51MB       47 hours ago
   108  tzh99xtzlaf6txllh3cobag8t         true           74.49MB       47 hours ago
   109  ld6laoeuo1kwapysu6afwqybl*        true           59.89MB       47 hours ago
   110  yitxizi5kaplpyomqpos2cryp*        true           59.83MB       47 hours ago
   111  iy8aa4b7qjn0qmy9wiga9cj8w         true           33.65MB       47 hours ago
   112  mci7okeijyp8aqqk16j80dy09         true           19.86MB       47 hours ago
   113  lqvj091he652slxdla4wom3pz         true           14.08MB       47 hours ago
   114  fkt31oiv793nd26h42llsjcw7*        true           11.87MB       2 days ago
   115  uj802yxtvkcjysnjb4kgwvn2v         true           11.68MB       45 hours ago
   116  Reclaimable:    2.627GB
   117  Total:          2.627GB
   118  ```