github.com/vieux/docker@v0.6.3-0.20161004191708-e097c2a938c7/docs/reference/commandline/system_df.md (about)

     1  <!--[metadata]>
     2  +++
     3  title = "system df"
     4  description = "The system df command description and usage"
     5  keywords = [system, data, usage, disk]
     6  [menu.main]
     7  parent = "smn_cli"
     8  +++
     9  <![end-metadata]-->
    10  
    11  # system df
    12  
    13  ```markdown
    14  Usage:	docker system df [OPTIONS]
    15  
    16  Show docker filesystem usage
    17  
    18  Options:
    19        --help      Print usage
    20    -v, --verbose   Show detailed information on space usage
    21  ```
    22  
    23  The `docker system df` command displays information regarding the
    24  amount of disk space used by the docker daemon.
    25  
    26  By default the command will just show a summary of the data used:
    27  ```bash
    28  $ docker system df
    29  TYPE                TOTAL               ACTIVE              SIZE                RECLAIMABLE
    30  Images              5                   2                   16.43 MB            11.63 MB (70%)
    31  Containers          2                   0                   212 B               212 B (100%)
    32  Local Volumes       2                   1                   36 B                0 B (0%)
    33  ```
    34  
    35  A more detailed view can be requested using the `-v, --verbose` flag:
    36  ```bash
    37  $ docker system df -v
    38  Images space usage:
    39  
    40  REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE                SHARED SIZE         UNIQUE SIZE         CONTAINERS
    41  my-curl             latest              b2789dd875bf        6 minutes ago       11 MB               11 MB               5 B                 0
    42  my-jq               latest              ae67841be6d0        6 minutes ago       9.623 MB            8.991 MB            632.1 kB            0
    43  <none>              <none>              a0971c4015c1        6 minutes ago       11 MB               11 MB               0 B                 0
    44  alpine              latest              4e38e38c8ce0        9 weeks ago         4.799 MB            0 B                 4.799 MB            1
    45  alpine              3.3                 47cf20d8c26c        9 weeks ago         4.797 MB            4.797 MB            0 B                 1
    46  
    47  Containers space usage:
    48  
    49  CONTAINER ID        IMAGE               COMMAND             LOCAL VOLUMES       SIZE                CREATED             STATUS                      NAMES
    50  4a7f7eebae0f        alpine:latest       "sh"                1                   0 B                 16 minutes ago      Exited (0) 5 minutes ago    hopeful_yalow
    51  f98f9c2aa1ea        alpine:3.3          "sh"                1                   212 B               16 minutes ago      Exited (0) 48 seconds ago   anon-vol
    52  
    53  Local Volumes space usage:
    54  
    55  NAME                                                               LINKS               SIZE
    56  07c7bdf3e34ab76d921894c2b834f073721fccfbbcba792aa7648e3a7a664c2e   2                   36 B
    57  my-named-vol                                                       0                   0 B
    58  ```
    59  
    60  * `SHARED SIZE` is the amount of space that an image shares with another one (i.e. their common data)
    61  * `UNIQUE SIZE` is the amount of space that is only used by a given image
    62  * `SIZE` is the virtual size of the image, it is the sum of `SHARED SIZE` and `UNIQUE SIZE`
    63  
    64  ## Related Information
    65  * [system prune](system_prune.md)
    66  * [container prune](container_prune.md)
    67  * [volume prune](volume_prune.md)
    68  * [image prune](image_prune.md)