Esta guía describe cómo instalar Docker Engine en Debian 12 (Bookworm) y configurarla de modo que se inicie automáticamente como servicio del sistema y permanezca actualizable a través de APT.

Actualización del sistema

Antes de la instalación, se recomienda actualizar por completo todos los paquetes existentes para evitar conflictos de versiones.

Herramientas necesarias

  • ca-certificates proporciona los certificados de emisores de confianza.

  • curl se usa para descargar la clave GPG de Docker.

  • gnupg convierte la clave a un formato legible por APT.

Crear el directorio de keyring

APT almacena las claves de repositorios desde Debian 12 en el directorio /etc/apt/keyrings
El directorio se crea con los permisos correctos:

Los permisos 0755 permiten acceso de lectura para todos, mientras que el acceso de escritura queda restringido a root.

Agregar la clave GPG oficial de Docker

  • La clave se descarga a través de una conexión HTTPS segura.

  • gpg –dearmor la convierte al formato binario que APT entiende.

  • chmod a+r asegura que APT pueda leer la clave.

Agregar el repositorio de Docker

  • Esta entrada agrega el repositorio estable de Docker.

  • arch define la arquitectura (p. ej., amd64),

  • signed-by vincula la clave específicamente a este repositorio.

Actualizar nuevamente las listas de paquetes

En la salida debería aparecer una línea como esta:

Instalar Docker

PaqueteDescripción
docker-ceServicio principal (dockerd)
docker-ce-cliHerramienta de línea de comandos
containerd.ioRuntime de contenedores
docker-buildx-pluginFunción de compilación avanzada (BuildKit)
docker-compose-pluginGestión de múltiples contenedores

Habilitar y arrancar el servicio

Prueba de funcionamiento