# docker system df

**Descripción:** Muestra el uso de disco de Docker

**Uso:** `docker system df [OPTIONS]`










## Descripción

El comando `docker system df` muestra información sobre la cantidad de espacio en disco utilizada por el demonio Docker.


## Opciones

| Opción                                                        | Predeterminado                                        | Descripción                                                                                                                                    |
| ------------------------------------------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | `--format` |  |  Da formato a la salida utilizando una plantilla personalizada:<br>'table':            Muestra la salida en formato de tabla con encabezados de columna (predeterminado)<br>'table TEMPLATE':   Muestra la salida en formato de tabla utilizando la plantilla de Go especificada<br>'json':             Muestra la salida en formato JSON<br>'TEMPLATE':         Muestra la salida utilizando la plantilla de Go especificada.<br>Consulta https://docs-docker.esdocu.com/go/formatting/ para obtener más información sobre cómo dar formato a la salida con plantillas |

 | `-v`, `--verbose` |  |  Muestra información detallada sobre el uso del espacio |




## Ejemplos

Por defecto, el comando muestra un resumen de los datos utilizados:

```console
$ docker system df

TYPE                TOTAL               ACTIVE              SIZE                RECLAIMABLE
Images              5                   2                   16.43 MB            11.63 MB (70%)
Containers          2                   0                   212 B               212 B (100%)
Local Volumes       2                   1                   36 B                0 B (0%)
```

Utiliza la opción `-v`, `--verbose` para obtener información más detallada:

```console
$ docker system df -v

Images space usage:

REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE                SHARED SIZE         UNIQUE SIZE         CONTAINERS
my-curl             latest              b2789dd875bf        6 minutes ago       11 MB               11 MB               5 B                 0
my-jq               latest              ae67841be6d0        6 minutes ago       9.623 MB            8.991 MB            632.1 kB            0
<none>              <none>              a0971c4015c1        6 minutes ago       11 MB               11 MB               0 B                 0
alpine              latest              4e38e38c8ce0        9 weeks ago         4.799 MB            0 B                 4.799 MB            1
alpine              3.3                 47cf20d8c26c        9 weeks ago         4.797 MB            4.797 MB            0 B                 1

Containers space usage:

CONTAINER ID        IMAGE               COMMAND             LOCAL VOLUMES       SIZE                CREATED             STATUS                      NAMES
4a7f7eebae0f        alpine:latest       "sh"                1                   0 B                 16 minutes ago      Exited (0) 5 minutes ago    hopeful_yalow
f98f9c2aa1ea        alpine:3.3          "sh"                1                   212 B               16 minutes ago      Exited (0) 48 seconds ago   anon-vol

Local Volumes space usage:

NAME                                                               LINKS               SIZE
07c7bdf3e34ab76d921894c2b834f073721fccfbbcba792aa7648e3a7a664c2e   2                   36 B
my-named-vol                                                       0                   0 B
```

* `SHARED SIZE` es la cantidad de espacio que una imagen comparte con otra (es decir, sus datos comunes)
* `UNIQUE SIZE` es la cantidad de espacio que es utilizada únicamente por una imagen determinada
* `SIZE` es el tamaño virtual de la imagen; es la suma de `SHARED SIZE` y `UNIQUE SIZE`

> [!NOTE]
> No se muestra la información de red, ya que no consume espacio en disco.