github.com/olljanat/moby@v1.13.1/docs/reference/commandline/system_df.md (about)

     1  ---
     2  title: "system df"
     3  description: "The system df command description and usage"
     4  keywords: "system, data, usage, disk"
     5  ---
     6  
     7  <!-- This file is maintained within the docker/docker Github
     8       repository at https://github.com/docker/docker/. Make all
     9       pull requests against that repo. If you see this file in
    10       another repository, consider it read-only there, as it will
    11       periodically be overwritten by the definitive file. Pull
    12       requests which include edits to this file in other repositories
    13       will be rejected.
    14  -->
    15  
    16  # system df
    17  
    18  ```markdown
    19  Usage:	docker system df [OPTIONS]
    20  
    21  Show docker filesystem usage
    22  
    23  Options:
    24        --help      Print usage
    25    -v, --verbose   Show detailed information on space usage
    26  ```
    27  
    28  The `docker system df` command displays information regarding the
    29  amount of disk space used by the docker daemon.
    30  
    31  By default the command will just show a summary of the data used:
    32  ```bash
    33  $ docker system df
    34  TYPE                TOTAL               ACTIVE              SIZE                RECLAIMABLE
    35  Images              5                   2                   16.43 MB            11.63 MB (70%)
    36  Containers          2                   0                   212 B               212 B (100%)
    37  Local Volumes       2                   1                   36 B                0 B (0%)
    38  ```
    39  
    40  A more detailed view can be requested using the `-v, --verbose` flag:
    41  ```bash
    42  $ docker system df -v
    43  Images space usage:
    44  
    45  REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE                SHARED SIZE         UNIQUE SIZE         CONTAINERS
    46  my-curl             latest              b2789dd875bf        6 minutes ago       11 MB               11 MB               5 B                 0
    47  my-jq               latest              ae67841be6d0        6 minutes ago       9.623 MB            8.991 MB            632.1 kB            0
    48  <none>              <none>              a0971c4015c1        6 minutes ago       11 MB               11 MB               0 B                 0
    49  alpine              latest              4e38e38c8ce0        9 weeks ago         4.799 MB            0 B                 4.799 MB            1
    50  alpine              3.3                 47cf20d8c26c        9 weeks ago         4.797 MB            4.797 MB            0 B                 1
    51  
    52  Containers space usage:
    53  
    54  CONTAINER ID        IMAGE               COMMAND             LOCAL VOLUMES       SIZE                CREATED             STATUS                      NAMES
    55  4a7f7eebae0f        alpine:latest       "sh"                1                   0 B                 16 minutes ago      Exited (0) 5 minutes ago    hopeful_yalow
    56  f98f9c2aa1ea        alpine:3.3          "sh"                1                   212 B               16 minutes ago      Exited (0) 48 seconds ago   anon-vol
    57  
    58  Local Volumes space usage:
    59  
    60  NAME                                                               LINKS               SIZE
    61  07c7bdf3e34ab76d921894c2b834f073721fccfbbcba792aa7648e3a7a664c2e   2                   36 B
    62  my-named-vol                                                       0                   0 B
    63  ```
    64  
    65  * `SHARED SIZE` is the amount of space that an image shares with another one (i.e. their common data)
    66  * `UNIQUE SIZE` is the amount of space that is only used by a given image
    67  * `SIZE` is the virtual size of the image, it is the sum of `SHARED SIZE` and `UNIQUE SIZE`
    68  
    69  Note that network information is not shown because it doesn't consume the disk space.
    70  
    71  ## Related Information
    72  * [system prune](system_prune.md)
    73  * [container prune](container_prune.md)
    74  * [volume prune](volume_prune.md)
    75  * [image prune](image_prune.md)
    76  * [network prune](network_prune.md)