Instalar Docker en Rocky Linux y AlmaLinux
Instala Docker Engine con dnf en Rocky Linux o AlmaLinux y resuelve dos problemas habituales: Podman ocupa docker y SELinux bloquea los bind mounts.
Instalar Docker en Rocky Linux y AlmaLinux
Para instalar Docker en Rocky Linux o AlmaLinux, añada el repositorio dnf propio de Docker, instale el motor con el complemento de Compose y habilite el servicio. Esa parte requiere cuatro comandos y es idéntica en ambas distribuciones porque las dos son reconstrucciones de Red Hat Enterprise Linux (RHEL) y comparten su diseño de paquetes. CentOS Stream funciona de la misma forma. Todo lo que sigue se aplica a ambas, así que, si todavía está eligiendo entre ellas, los factores decisivos son la promesa de compatibilidad de cada proyecto y si su CPU antigua sigue siendo compatible.
La instalación es breve, por lo que la mayor parte de esta guía explica las diferencias de Enterprise Linux (EL) respecto de Ubuntu. Podman puede tener ya asignado el comando docker en su imagen. SELinux confina los contenedores sólo después de activar la compatibilidad de Docker con SELinux. A partir de ese momento, bloquea los archivos montados mediante bind mount hasta que tengan la etiqueta adecuada. Firewalld no filtra los puertos publicados por Docker, por lo que un puerto de contenedor puede estar abierto a Internet mientras firewall-cmd indica que no hay ningún puerto abierto.
No use el script de conveniencia de Docker de get.docker.com. La documentación de Docker indica que no se recomienda para producción. Reescribe la configuración del repositorio sin pedir confirmación y no se puede volver a ejecutar de forma segura para actualizar. Añadir el repositorio manualmente hace que dnf upgrade trate Docker como cualquier otro paquete del sistema. También incluye el motor en el ámbito de dnf-automatic, si lo tiene configurado para aplicar actualizaciones de seguridad según un horario, así que decida pronto si quiere actualizar Docker sin intervención o posponer las actualizaciones hasta una ventana de mantenimiento. En ambos casos, una actualización reemplaza el binario del paquete mientras el proceso antiguo dockerd sigue ejecutándose, y needs-restarting es el comando que indica qué servicios todavía ejecutan el código que acaba de reemplazar.
¿podman ya está respondiendo al comando docker?
Rocky Linux y AlmaLinux incluyen podman en sus repositorios predeterminados, y muchas imágenes de VPS lo instalan automáticamente. Algunas imágenes van más allá e instalan podman-docker, que coloca un script de shell en /usr/bin/docker para llamar a podman. A partir de ese momento, cada comando docker que escriba ejecuta podman, por lo que una guía escrita para Docker empieza a mostrar resultados inesperados.
La primera señal es un banner. El script /usr/bin/docker busca un archivo llamado nodocker en /etc/containers y en su propio directorio ~/.config/containers (en $XDG_CONFIG_HOME si lo ha definido). Si no existe ninguno de los dos archivos, muestra una línea antes de ejecutar cualquier acción:
Emulate Docker CLI using podman. Create /etc/containers/nodocker to quiet msg.Alguien puede haber creado cualquiera de los dos archivos para ocultar el banner, así que no se base sólo en él. Consulte en la base de datos de paquetes qué paquete es propietario del binario:
command -v docker
rpm -qf "$(command -v docker)"Una respuesta que empiece por podman-docker significa que podman está respondiendo. Una respuesta que empiece por docker-ce-cli significa que se trata del Docker real. Si rpm -qf informa de que ningún paquete es propietario del archivo, alguien lo instaló manualmente y debe leer el script antes de confiar en él.
Podman ejecuta las mismas imágenes OCI y es una opción razonable. Si quiere usarlo, puede detenerse aquí. Ambos son motores de contenedores para Linux, así que, si la decisión sobre la plataforma sigue abierta, conviene saber que las jaulas de FreeBSD aíslan un userland completo en lugar de ejecutar imágenes por capas obtenidas de un registro. Si quiere Docker Engine, elimine primero los paquetes en conflicto. Esta es la lista que Docker documenta para RHEL:
sudo dnf remove docker docker-client docker-client-latest docker-common \
docker-latest docker-latest-logrotate docker-logrotate docker-engine podman runcLea lo que dnf planea eliminar antes de confirmar. En una imagen de VPS nueva, la lista es corta. En un sistema que alguien ya haya utilizado, eliminar podman puede eliminar también cockpit-podman u otra herramienta que dependa de él.
En principio, es posible mantener podman junto con Docker: elimine sólo podman-docker, para liberar el nombre docker, y runc, que el paquete containerd.io reemplaza. La documentación de Docker considera podman un paquete en conflicto, por lo que Docker no admite esta configuración. Si la instalación sigue informando de un conflicto, use la lista completa de eliminación anterior.
Añadir el repositorio de Docker con dnf config-manager
Docker publica paquetes RPM para Enterprise Linux en download.docker.com. El archivo del repositorio apunta al árbol de CentOS, que es el que utilizan Rocky Linux y AlmaLinux. Apuntar un sistema Rocky a un repositorio de CentOS parece un error hasta conocer cómo ambas distribuciones surgieron de la línea de desarrollo de CentOS después de que Red Hat convirtiera CentOS en Stream en 2020. Comprobado el 10 de noviembre de 2026, Docker documenta este repositorio para CentOS Stream 9 y CentOS Stream 10.
sudo dnf -y install dnf-plugins-core
sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repoLa versión 5 de dnf eliminó el argumento --add-repo, por lo que el segundo comando falla en las versiones más recientes. Compruebe cuál tiene y elija la forma correspondiente:
dnf --versionSi muestra una versión 5.x, use en su lugar la forma con subcomando:
sudo dnf config-manager addrepo --from-repofile=https://download.docker.com/linux/centos/docker-ce.repoAmbas formas escriben el mismo archivo en /etc/yum.repos.d/docker-ce.repo. La forma incorrecta falla con un error de argumento desconocido en lugar de producir un resultado incorrecto de forma silenciosa, por lo que lo detectará.
Ese archivo del repositorio establece baseurl en una ruta que contiene $releasever, y dnf expande esa variable a partir del paquete de versión instalado. Rocky Linux y AlmaLinux le asignan el número de versión principal, por lo que 9 en EL 9 y 10 en EL 10. Por eso un repositorio de CentOS se resuelve correctamente en un sistema Rocky. Confirme la expansión antes de instalar:
sudo dnf repoinfo docker-ce-stableLea la línea Repo-baseurl. Debe terminar en /9/x86_64/stable o /10/x86_64/stable. Si la versión instalada establece $releasever en una versión específica, como 9.6, la línea muestra /9.6/ en su lugar y dnf informa Status code: 404 para esa URL al descargar los metadatos. Corríjalo editando /etc/yum.repos.d/docker-ce.repo y sustituyendo $releasever por el número principal sin más elementos. Un error 404 no lo demuestra por sí solo. Red Hat enumera otras causas para el mismo error, como metadatos de repositorio incoherentes y una URL base incorrecta. Por tanto, edite el archivo sólo cuando Repo-baseurl muestre realmente una versión específica. Si ya termina en el número principal, sustituir la variable no cambia nada.
Instalar el motor y el complemento de Compose
sudo dnf install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-pluginSon cinco paquetes y cada uno cumple una función. docker-ce es el daemon de dockerd. docker-ce-cli es el comando de docker que se escribe. containerd.io es el runtime de contenedores que controla el daemon. docker-buildx-plugin compila imágenes. docker-compose-plugin proporciona docker compose como subcomando.
Estos paquetes no instalan un binario docker-compose con guion. Ese binario pertenecía a Compose v1, cuya vida útil Docker dio por terminada cuando Compose v2 pasó a estar disponible de forma general. Todo lo que invoque docker-compose con un guion debe actualizarse a docker compose con un espacio.
La primera instalación se detiene para importar la clave de firma de Docker y muestra su huella digital. La clave procede de gpgkey=https://download.docker.com/linux/centos/gpg en el archivo del repositorio que acaba de añadir, así que compare la huella que muestra dnf con esa URL antes de aceptarla.
Hay un fallo que aparece con suficiente frecuencia como para mencionarlo. Si dnf informa de que containerd.io requiere container-selinux y ningún paquete lo proporciona, el repositorio AppStream está deshabilitado. Ejecute dnf repolist y confirme que aparece appstream, porque ahí se publica container-selinux en EL 9 y EL 10.
Inicie Docker y confirme que funciona
sudo systemctl enable --now docker
sudo systemctl status docker --no-pager
sudo docker run --rm hello-worldLos paquetes RPM de Docker dejan el daemon detenido y deshabilitado después de la instalación. Por eso este paso aparece en la página de Docker para CentOS y no en la de Ubuntu, donde el paquete deb inicia el servicio automáticamente. Omita enable y Docker funcionará hasta el siguiente reinicio. Después permanecerá detenido y dejará fuera de servicio todos los contenedores.
systemctl status debe mostrar Active: active (running). El contenedor hello-world debe imprimir This message shows that your installation appears to be working correctly. y finalizar. Si en su lugar imprime un error de permisos sobre /var/run/docker.sock, omitió sudo. La sección sobre el grupo docker que aparece más abajo corrige este problema.
Compruebe el complemento de Compose por separado. Es un paquete distinto y puede faltar aunque el motor funcione correctamente:
docker compose versionEn una instalación nueva, una respuesta correcta tiene este aspecto: Docker Compose version v5.7.0. Esa es la versión que el repositorio EL 9 de Docker distribuye desde el 10 de noviembre de 2026. No se sorprenda por el salto de v2 a v5. Docker publicó Compose v5 en 2025 con una funcionalidad idéntica a la de v2 y omitió los números intermedios para evitar confusiones con los formatos de archivo de Compose heredados, etiquetados como v2 y v3. Docker admite Compose v2 y Compose v5. Por tanto, un sistema antiguo que responda v2.x.x sigue funcionando, y dnf upgrade lo actualiza a v5. Recuperar los servicios después de un reinicio es una cuestión distinta de habilitar el daemon, y las políticas de reinicio determinan si los servicios de Compose vuelven a iniciarse durante el arranque.
¿Por qué un bind mount devuelve «permission denied»?
Rocky Linux y AlmaLinux ejecutan SELinux (Security-Enhanced Linux) en modo enforcing de forma predeterminada. Confírmelo con getenforce, que muestra Enforcing.
La aplicación de políticas del host no confina por sí sola los contenedores de Docker. La compatibilidad de Docker con SELinux es un ajuste del daemon, selinux-enabled, que está desactivado de forma predeterminada, y el paquete docker-ce no lo activa. Cuando está desactivado, los contenedores se ejecutan como spc_t, un tipo sin confinamiento. Por eso un bind mount funciona sin ninguna etiqueta y SELinux no separa el contenedor del host. Para que SELinux confine los contenedores, active el ajuste en /etc/docker/daemon.json y reinicie el daemon. Si ese archivo ya contiene ajustes, añada la clave al objeto existente en lugar de sobrescribir el archivo:
echo '{ "selinux-enabled": true }' | sudo tee /etc/docker/daemon.json
sudo systemctl restart dockerCon el etiquetado activado, los contenedores de Docker se ejecutan con el tipo de SELinux container_t. La política concede a ese tipo acceso completo a los archivos etiquetados como container_file_t y a algunos tipos de sistema de archivos, como nfs_t, además de acceso de lectura a otros, como container_ro_file_t. No concede acceso a las etiquetas genéricas que tienen los directorios normales del host. Un directorio creado en el host conserva la etiqueta que le asigna su ruta padre. Por eso se deniega el acceso al contenedor aunque el propietario, el grupo y el modo parezcan correctos desde el host. Reprodúzcalo con tres comandos:
sudo mkdir -p /srv/site
echo hello | sudo tee /srv/site/index.html
sudo docker run --rm -v /srv/site:/usr/share/nginx/html:ro nginx:alpine cat /usr/share/nginx/html/index.htmlEl contenedor muestra:
cat: can't open '/usr/share/nginx/html/index.html': Permission deniedDos comandos muestran la causa. ls -ldZ /srv/site muestra la etiqueta. Para una ruta bajo /srv, esa etiqueta es system_u:object_r:var_t:s0, no container_file_t. Después, sudo ausearch -m avc -ts recent muestra el registro de auditoría del kernel. Este contiene avc: denied { read }, un campo scontext= que identifica container_t y un campo tcontext= que identifica la etiqueta que acaba de ver en el directorio. La discrepancia entre esos dos campos explica todo el problema.
La solución es añadir un sufijo al argumento del volumen. Docker vuelve a etiquetar la ruta automáticamente:
sudo docker run --rm -v /srv/site:/usr/share/nginx/html:ro,z nginx:alpine cat /usr/share/nginx/html/index.html:z en minúsculas vuelve a etiquetar el contenido como compartido, para que varios contenedores puedan usar el mismo directorio. :Z en mayúsculas lo vuelve a etiquetar como privado y no compartido, asociado a un solo contenedor. En ese caso, un segundo contenedor que lea la misma ruta recibe una denegación. Use :z para todo lo que también utilice un sidecar o un contenedor de copias de seguridad. Use :Z para un directorio de base de datos que sea propiedad de un solo contenedor.
La documentación de Docker incluye una advertencia que conviene repetir, porque el cambio de etiqueta es recursivo. Montar mediante bind un directorio del sistema, como /home o /usr, con :Z «deja el host inutilizable y es posible que tenga que volver a etiquetar manualmente los archivos del host». Apunte estos sufijos a directorios que haya creado para el contenedor, nunca a una ruta del sistema.
En Compose, el sufijo se añade a la misma cadena:
services:
web:
image: nginx:alpine
volumes:
- /srv/site:/usr/share/nginx/html:ro,zEs fácil encontrarse con dos limitaciones. El indicador --mount no puede establecer ninguna etiqueta de SELinux. Use -v cuando necesite establecer una. Los volúmenes con nombre no necesitan sufijo, porque Docker etiqueta por sí mismo los directorios que crea bajo /var/lib/docker/volumes.
No desactive SELinux. Use sudo setenforce 0 sólo como prueba de un minuto: si el contenedor funciona entonces, SELinux es lo que lo bloquea, aunque no necesariamente por la etiqueta del bind mount. Lea el campo tcontext= de la denegación. Si contiene la etiqueta del directorio, :z es la solución. Si identifica un dispositivo, normalmente la solución es un booleano de políticas, como sudo setsebool -P container_use_xserver_devices 1 para un dispositivo de servidor X montado en el contenedor. Vuelva a activar el modo enforcing inmediatamente con sudo setenforce 1. En Enterprise Linux, permission denied en un bind mount tiene dos causas independientes que desde dentro del contenedor parecen iguales. Una es la etiqueta de SELinux. La otra es la propiedad numérica normal del usuario y del grupo, que es lo que las variables PUID y PGID permiten resolver. ls -lnZ muestra en una sola línea el modo, el propietario numérico y la etiqueta, para que pueda determinar cuál de los dos problemas está corrigiendo.
¿Por qué se puede acceder a un puerto publicado cuando firewalld parece estar cerrado?
Firewalld es el firewall predeterminado en Rocky Linux y AlmaLinux. Compruebe que esté en ejecución con sudo systemctl is-active firewalld. Si todavía no lo ha configurado en este equipo, primero debe abrir SSH y un puerto web con firewalld, porque lo siguiente sólo tiene sentido cuando ya existe un conjunto de reglas de zona funcional con el que comparar. Publique ahora un puerto y compruebe qué considera abierto firewalld:
sudo docker run -d --name web -p 8080:80 nginx:alpine
sudo firewall-cmd --list-portsfirewall-cmd muestra una línea vacía. Desde otra máquina, curl -I http://YOUR_SERVER_IP:8080/ devuelve HTTP/1.1 200 OK. El puerto está abierto a Internet, pero el firewall no informa de nada.
La causa es la ruta que sigue el paquete. Las reglas de zona de firewalld filtran el tráfico dirigido al propio host. Un puerto publicado no está dirigido al host: Docker instala una regla de NAT de destino (traducción de direcciones de red) que cambia el destino a la dirección del contenedor antes de que el paquete llegue a la ruta de entrada del host. Por eso, el kernel reenvía el paquete en lugar de entregarlo localmente. Docker coloca después sus interfaces de bridge en una zona de firewalld llamada docker, cuyo destino es ACCEPT, y añade una política de reenvío llamada docker-forwarding que permite reenviar tráfico desde cualquier zona hacia la zona docker. Las reglas de su zona nunca ven el paquete.
La solución más limpia no necesita ninguna regla del firewall. Vincule el lado del host de la publicación a loopback y coloque un reverse proxy delante:
sudo docker rm -f web
sudo docker run -d --name web -p 127.0.0.1:8080:80 nginx:alpine
curl -I http://127.0.0.1:8080/El comando local curl devuelve HTTP/1.1 200 OK y la misma solicitud desde otra máquina ya no conecta. Con la configuración predeterminada de Docker, un argumento -p sin dirección de host publica el puerto en todas las interfaces. La excepción es un daemon cuyo valor predeterminado de dirección de vinculación haya sido cambiado, por ejemplo mediante "ip": "127.0.0.1" en /etc/docker/daemon.json. Si no sabe si eso se hizo en este equipo, trate un -p 8080:80 sin dirección de host como una decisión de exponer públicamente ese servicio.
Cuando necesite que un servicio sea accesible desde algunas direcciones y no desde otras, Docker reserva una cadena para este fin. DOCKER-USER se procesa antes de las reglas propias de aceptación de Docker, por lo que una regla colocada allí permanece después de que Docker reinicie y vuelva a escribir sus cadenas:
sudo iptables -I DOCKER-USER -i enp1s0 ! -s 203.0.113.10 -j DROP
sudo iptables -S DOCKER-USERObtenga el nombre de la interfaz de ip route show default en lugar de suponer eth0, porque las imágenes EL actuales usan nombres como enp1s0 o ens3. En Rocky y AlmaLinux, el comando iptables es una capa de compatibilidad sobre nftables, y las cadenas de Docker son visibles mediante este comando. Las reglas añadidas de esta forma se pierden después de un reinicio si no las guarda. Cuando esté conforme con ellas, escríbalas en una unidad de systemd.
Docker Engine 28.0, publicado en 2025, cerró una vulnerabilidad relacionada: el acceso directo enrutado a puertos de contenedor que nunca se publicaron ahora se bloquea en la cadena DOCKER. Ese cambio no afecta a los puertos publicados, por lo que todo lo anterior sigue siendo aplicable en las versiones actuales. Conviene adoptar un hábito operativo: después de cualquier sudo firewall-cmd --reload, vuelva a probar un puerto publicado. Si dejó de responder, sudo systemctl restart docker reinstala las reglas de Docker.
Los administradores de Ubuntu encuentran el mismo problema mediante otra herramienta: por qué los puertos publicados de Docker ignoran las reglas de ufw. La ruta de NAT es la causa en ambos casos. Lo único que cambia es el firewall situado delante.
Añadir un usuario no root al grupo docker
Escribir sudo antes de cada comando docker resulta tedioso, y el grupo docker evita tener que hacerlo:
sudo usermod -aG docker $USER
newgrp docker
docker run --rm hello-worldusermod -aG edita /etc/group, pero el shell actual ya tiene su propia lista de grupos, por lo que el cambio no se aplica hasta que se inicia una nueva sesión. newgrp docker inicia un shell con el grupo asociado para que pueda probarlo de inmediato. Las nuevas sesiones SSH lo incorporan automáticamente.
Tenga claro qué permisos concede ese grupo. La pertenencia proporciona acceso de escritura a /var/run/docker.sock, y cualquier proceso que pueda comunicarse con ese socket puede pedir al daemon que inicie un contenedor con el sistema de archivos del host montado. Un comando muestra las consecuencias:
docker run --rm -v /:/host alpine wc -l /host/etc/shadowEse comando lee un archivo que sólo root puede leer desde una cuenta sin permisos de sudo. La documentación de Docker posterior a la instalación indica lo mismo: el grupo docker concede privilegios equivalentes a los de root. Añada una cuenta a ese grupo sólo si también le concedería sudo. Si está configurando cuentas en un servidor nuevo, decida esto junto con el resto de su configuración de usuarios con privilegios mínimos en un VPS, en lugar de hacerlo después.
Docker también ofrece un modo rootless que ejecuta el daemon como un usuario sin privilegios. Es una ruta de instalación independiente y cambia el funcionamiento de los controladores de almacenamiento y de los puertos inferiores a 1024, por lo que debe planificarse como un proyecto propio y no como un indicador que se añade más adelante.
Dónde continuar
Ya tiene el motor, el complemento de Compose, un servicio que sobrevive a los reinicios y los tres comportamientos específicos de EL documentados anteriormente. El siguiente paso es una compose.yaml por servicio, y la estructura de un archivo de Compose explica el formato del archivo y los comandos que lo gestionan. Si este es su primer host de contenedores, ejecutar Docker en un VPS aborda las cuestiones de dimensionamiento, almacenamiento e higiene de imágenes que quedan fuera de esta guía.
FAQ
¿Funciona el repositorio de Docker para CentOS en Rocky Linux y AlmaLinux?
Sí. Añada https://download.docker.com/linux/centos/docker-ce.repo con dnf config-manager. El baseurl de ese archivo contiene $releasever, y Rocky Linux y AlmaLinux lo expanden al número de versión principal. Por tanto, un sistema EL 9 resuelve al árbol de CentOS 9 y un sistema EL 10 al árbol de CentOS 10. Confirme la expansión con sudo dnf repoinfo docker-ce-stable y lea la línea Repo-baseurl. Si esa línea muestra una versión menor, como 9.6, y dnf informa Status code: 404 al descargar los metadatos, editar /etc/yum.repos.d/docker-ce.repo para usar únicamente el número de versión principal lo corrige. Si la línea ya muestra el número principal, el error 404 tiene otra causa, como unos metadatos del repositorio incoherentes o una URL base incorrecta. Editar la variable no lo solucionará.
¿Se pueden instalar Docker y podman en el mismo servidor?
La documentación de Docker incluye podman y runc como paquetes incompatibles y le indica que elimine ambos antes de instalar Docker Engine. El conflicto concreto es el paquete podman-docker, que es propietario de /usr/bin/docker y convierte cada comando docker en un comando de podman. Ejecute rpm -qf "$(command -v docker)" para ver qué paquete es propietario de esa ruta. Si la salida comienza por podman-docker, podman está respondiendo. Mantener ambos motores no es una configuración compatible con Docker. En un servidor importante, elija uno.
¿Por qué mi contenedor recibe «permission denied» en un montaje bind?
SELinux se aplica de forma predeterminada en Rocky Linux y AlmaLinux. Cuando la opción selinux-enabled de Docker está activada, los contenedores se ejecutan con el tipo container_t. Esta opción está desactivada de forma predeterminada. Ese tipo no tiene acceso a las etiquetas genéricas que llevan los directorios normales del host. Por eso se deniega el acceso a un directorio que haya creado, independientemente de su propietario y sus permisos. Confírmelo con ls -ldZ sobre la ruta del host y con sudo ausearch -m avc -ts recent, que muestra avc: denied con los dos contextos que no coinciden. Añada :z al argumento del volumen para el contenido compartido entre contenedores, o :Z para el contenido privado de uno solo. Nunca apunte :Z a /home ni a /usr, porque la relabelización es recursiva y dañará el host.
¿Tengo que abrir un puerto en firewalld para publicar el puerto de un contenedor?
No. Ese es el problema. La regla NAT de Docker reescribe la dirección de destino antes de que el paquete llegue a la ruta de entrada del host. Por tanto, las reglas de zona de firewalld nunca lo inspeccionan. Docker también coloca sus bridges en una zona de firewalld llamada docker, con el destino ACCEPT. Un contenedor iniciado con -p 8080:80 es accesible desde Internet, aunque sudo firewall-cmd --list-ports no muestre nada. Publique el servicio en una dirección específica con -p 127.0.0.1:8080:80 cuando sólo el host deba acceder a él, o inserte reglas de filtrado en la cadena DOCKER-USER, que Docker procesa antes que sus propias reglas de aceptación.
¿Es seguro añadir mi usuario al grupo docker?
Concede acceso root. Un miembro del grupo docker puede escribir en /var/run/docker.sock, y docker run --rm -v /:/host alpine wc -l /host/etc/shadow puede leer después un archivo exclusivo de root desde una cuenta sin permisos de sudo. La documentación de Docker sobre las tareas posteriores a la instalación indica la misma equivalencia. Añada sólo cuentas a las que ya confiaría sudo, y siga usando sudo docker para las cuentas compartidas o de servicio. El modo rootless es la alternativa cuando necesita ejecutar contenedores con un usuario sin privilegios. Es una ruta de instalación independiente, no una opción de configuración.