github.com/sld880311/docker@v0.0.0-20200524143708-d5593973a475/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  ## Performance
    81  
    82  The `system df` command can be very resource-intensive. It traverses the
    83  filesystem of every image, container, and volume in the system. You should be
    84  careful running this command in systems with lots of images, containers, or
    85  volumes or in systems where some images, containers, or volumes have very large
    86  filesystems with many files. You should also be careful not to run this command
    87  in systems where performance is critical.
    88  
    89  ## Related commands
    90  * [system prune](system_prune.md)
    91  * [container prune](container_prune.md)
    92  * [volume prune](volume_prune.md)
    93  * [image prune](image_prune.md)
    94  * [network prune](network_prune.md)