# Limpieza de espacio en disco de Docker

## Limpieza de espacio en disco de Docker (Hosts)

Los datos de Docker crecen con el tiempo en las máquinas host.\
Los alquileres antiguos dejan contenedores detenidos, imágenes sin usar, volúmenes y caché de compilación.\
Si no lo limpias, el disco raíz se llena y los despliegues empiezan a fallar.

{% hint style="info" %}
Ejecuta la limpieza solo cuando el servidor esté **no alquilado** y no necesites ningún dato antiguo de contenedores.\
Si no estás seguro, detente aquí y primero haz una comprobación de uso de disco.
{% endhint %}

***

## 1) Comprobar uso de disco

### Espacio en disco a nivel de SO (`df -h`)

Esto muestra el espacio libre en cada sistema de archivos montado.

```bash
df -h
```

Te interesa principalmente `/` (raíz) y la partición que contiene `/var/lib/docker`.

### Uso de disco a nivel de Docker (`docker system df`)

Esto muestra qué está almacenando Docker y cuánto se puede recuperar.

```bash
docker system df
```

Si quieres más detalle por imagen/contenedor:

```bash
docker system df -v
```

***

## 2) Limpieza completa (recomendado)

Este es el comando para “restablecer los restos de Docker de alquileres anteriores”.\
Elimina contenedores, imágenes, redes y **volúmenes no usados**.

```bash
docker system prune -a --volumes
```

{% hint style="warning" %}
`-a` elimina **todas las imágenes no usadas**, no solo las “colgantes”.\
Eso incluye imágenes en caché que podrías querer para despliegues más rápidos en el futuro.
{% endhint %}

***

## 3) Comandos de limpieza individuales (más control)

Usa estos cuando quieras limpiar una categoría específica.\
Son más seguros para mantenimiento incremental.

### Contenedores (solo detenidos)

```bash
docker container prune
```

### Imágenes (no usadas)

Eliminar solo capas colgantes:

```bash
docker image prune
```

Eliminar todas las imágenes no usadas (mismo riesgo que `system prune -a`):

```bash
docker image prune -a
```

### Volúmenes (no usados)

```bash
docker volume prune
```

### Redes (no usadas)

```bash
docker network prune
```

***

## 4) Mejores prácticas para el mantenimiento del host

1. Limpia **entre alquileres** o durante tiempos de inactividad planificados.
2. Mantén un margen de seguridad.\
   Apunta a **10–20 GB** libres en el disco raíz en todo momento.
3. Comprueba el uso de Docker regularmente:
   * `df -h`
   * `docker system df`
4. Prefiere la limpieza incremental primero:
   * `docker container prune`
   * `docker image prune`
   * `docker volume prune`
5. Usa la limpieza completa solo cuando sea necesario:
   * `docker system prune -a --volumes`
6. Si el uso de disco sigue creciendo rápidamente, investiga:
   * Volúmenes grandes creados por los arrendatarios.
   * Registros bajo `/var/lib/docker/containers/*/*.log`.
   * Caché de compilación por reconstrucciones frecuentes de imágenes.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.clore.ai/clore.ai/clore.ai-eng-es/para-anfitriones/server-offline-on-clore.ai/docker-disk-space-cleanup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.