github.com/fabiokung/docker@v0.11.2-0.20170222101415-4534dcd49497/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  ## Description
    29  
    30  The `docker system df` command displays information regarding the
    31  amount of disk space used by the docker daemon.
    32  
    33  ## Examples
    34  
    35  By default the command will just show a summary of the data used:
    36  
    37  ```bash
    38  $ docker system df
    39  
    40  TYPE                TOTAL               ACTIVE              SIZE                RECLAIMABLE
    41  Images              5                   2                   16.43 MB            11.63 MB (70%)
    42  Containers          2                   0                   212 B               212 B (100%)
    43  Local Volumes       2                   1                   36 B                0 B (0%)
    44  ```
    45  
    46  A more detailed view can be requested using the `-v, --verbose` flag:
    47  
    48  ```bash
    49  $ docker system df -v
    50  
    51  Images space usage:
    52  
    53  REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE                SHARED SIZE         UNIQUE SIZE         CONTAINERS
    54  my-curl             latest              b2789dd875bf        6 minutes ago       11 MB               11 MB               5 B                 0
    55  my-jq               latest              ae67841be6d0        6 minutes ago       9.623 MB            8.991 MB            632.1 kB            0
    56  <none>              <none>              a0971c4015c1        6 minutes ago       11 MB               11 MB               0 B                 0
    57  alpine              latest              4e38e38c8ce0        9 weeks ago         4.799 MB            0 B                 4.799 MB            1
    58  alpine              3.3                 47cf20d8c26c        9 weeks ago         4.797 MB            4.797 MB            0 B                 1
    59  
    60  Containers space usage:
    61  
    62  CONTAINER ID        IMAGE               COMMAND             LOCAL VOLUMES       SIZE                CREATED             STATUS                      NAMES
    63  4a7f7eebae0f        alpine:latest       "sh"                1                   0 B                 16 minutes ago      Exited (0) 5 minutes ago    hopeful_yalow
    64  f98f9c2aa1ea        alpine:3.3          "sh"                1                   212 B               16 minutes ago      Exited (0) 48 seconds ago   anon-vol
    65  
    66  Local Volumes space usage:
    67  
    68  NAME                                                               LINKS               SIZE
    69  07c7bdf3e34ab76d921894c2b834f073721fccfbbcba792aa7648e3a7a664c2e   2                   36 B
    70  my-named-vol                                                       0                   0 B
    71  ```
    72  
    73  * `SHARED SIZE` is the amount of space that an image shares with another one (i.e. their common data)
    74  * `UNIQUE SIZE` is the amount of space that is only used by a given image
    75  * `SIZE` is the virtual size of the image, it is the sum of `SHARED SIZE` and `UNIQUE SIZE`
    76  
    77  > **Note**: Network information is not shown because it doesn't consume the disk
    78  > space.
    79  
    80  ## Related commands
    81  * [system prune](system_prune.md)
    82  * [container prune](container_prune.md)
    83  * [volume prune](volume_prune.md)
    84  * [image prune](image_prune.md)
    85  * [network prune](network_prune.md)