# docker volume prune

**Descripción:** Elimina los volúmenes locales no utilizados

**Uso:** `docker volume prune [OPTIONS]`










## Descripción

Elimina todos los volúmenes locales no utilizados. Los volúmenes locales no utilizados son aquellos que no están referenciados por ningún contenedor. Por defecto, solo elimina los volúmenes anónimos.


## Opciones

| Opción                                                        | Predeterminado                                        | Descripción                                                                                                                                    |
| ------------------------------------------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | `-a`, `--all` |  | API 1.42+ Elimina todos los volúmenes no utilizados, no solo los anónimos |

 | `--filter` |  |  Proporciona valores de filtrado (por ejemplo, `label=<etiqueta>`) |

 | `-f`, `--force` |  |  No solicita confirmación |




## Ejemplos

```console
$ docker volume prune

WARNING! This will remove anonymous local volumes not used by at least one container.
Are you sure you want to continue? [y/N] y
Deleted Volumes:
07c7bdf3e34ab76d921894c2b834f073721fccfbbcba792aa7648e3a7a664c2e

Total reclaimed space: 36 B
```

### Filtrado (--all, -a) {#all}

Utiliza la opción `--all` para eliminar tanto los volúmenes anónimos como los volúmenes con nombre no utilizados.

### Filtrado (--filter) {#filter}

El formato de la opción de filtrado (`--filter`) es de "clave=valor". Si hay más de un filtro, pasa múltiples opciones (por ejemplo, `--filter "foo=bar" --filter "bif=baz"`).

Cuando se proporcionan múltiples filtros, se combinan de la siguiente manera:

- Los filtros múltiples con **diferentes claves** se combinan utilizando la lógica AND. Un volumen debe cumplir todas las condiciones del filtro para ser eliminado.
- Los filtros múltiples con la **misma clave** se combinan utilizando la lógica OR. Un volumen se elimina si coincide con cualquiera de los valores de esa clave.

Por ejemplo, `--filter "label=foo" --filter "label=bar"` elimina los volúmenes que tienen la etiqueta `foo` o `bar`, mientras que `--filter "label=foo" --filter "label!=bar"` elimina los volúmenes que tienen la etiqueta `foo` y no tienen la etiqueta `bar`.

Los filtros admitidos actualmente son:

* label (`label=<clave>`, `label=<clave>=<valor>`, `label!=<clave>` o `label!=<clave>=<valor>`) - solo elimina los volúmenes con (o sin, en caso de utilizar `label!=...`) las etiquetas especificadas.

El filtro `label` admite dos formatos. Uno es el `label=...` (`label=<clave>` o `label=<clave>=<valor>`), que elimina los volúmenes con las etiquetas especificadas. El otro formato es `label!=...` (`label!=<clave>` o `label!=<clave>=<valor>`), que elimina los volúmenes sin las etiquetas especificadas.