Qué necesitas antes de instalar Docker
Necesitas un VPS con una distribución Linux de 64 bits soportada, acceso con permisos de administrador (sudo) y una conexión SSH. Docker Engine funciona sobre Ubuntu, Debian, Rocky Linux, AlmaLinux, Fedora y otras distribuciones; los comandos de esta guía usan Ubuntu, que es la base más común.
Para aprender basta con 2 GB de RAM. En producción, la memoria depende de cuántos contenedores levantes y qué hagan: una base de datos y varias aplicaciones piden bastante más que un sitio estático. Reserva también espacio en disco, porque las imágenes y los logs crecen con el tiempo.
Un detalle que ahorra dolores de cabeza: no instales Docker con apt install docker.io ni con Snap. Esos paquetes existen, pero van por detrás en versiones y mezclan rutas. El camino que la propia documentación recomienda es el repositorio oficial de Docker, que es el que verás a continuación.
Instalar Docker desde el repositorio oficial
La forma correcta de instalar Docker es añadir el repositorio oficial y luego instalar el motor. Primero preparas la llave GPG que verifica que los paquetes son auténticos:
sudo apt update
sudo apt install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.ascDespués declaras el repositorio oficial y ya puedes instalar Docker Engine junto con sus plugins:
sudo tee /etc/apt/sources.list.d/docker.sources > /dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo systemctl enable --now dockerEse último comando arranca el servicio de Docker y lo deja activado para que se levante solo cada vez que reinicies el VPS. Con esto tienes instalado el motor, la línea de comandos, Buildx y Compose de una sola vez.
Docker Compose ya viene incluido
Buena noticia: no tienes que instalar Docker Compose por separado. En el comando anterior, el paquete docker-compose-plugin instaló Compose como parte del motor. Docker Compose es la herramienta que te deja describir varios contenedores en un solo archivo docker-compose.yml y levantarlos todos con un comando, en lugar de escribir un docker run gigante por cada servicio.
Comprueba que quedó instalado:
docker compose versionFíjate en el detalle: se escribe docker compose, con espacio y sin guion. La versión antigua era docker-compose (con guion), un programa aparte que ya está descontinuado. Si sigues un tutorial viejo que usa el guion, ese es el motivo de que te dé "command not found". Para profundizar, tenemos una guía dedicada a Docker Compose en un VPS.
Dar permisos a tu usuario para usar Docker sin sudo
Por defecto, solo root puede hablar con el daemon de Docker, así que tendrás que escribir sudo delante de cada comando. Para evitarlo, añade tu usuario al grupo docker:
sudo usermod -aG docker "$USER"Cierra la sesión SSH y vuelve a entrar para que el cambio surta efecto. A partir de ahí, docker ps funciona sin sudo.
Ahora la advertencia honesta: pertenecer al grupo docker equivale, en la práctica, a tener privilegios de root en la máquina. Alguien de ese grupo puede montar el disco del host dentro de un contenedor y hacer casi cualquier cosa. No es un mecanismo de aislamiento. Añade a ese grupo únicamente a administradores de confianza; para el resto, deja sudo con reglas limitadas.
Tu primer contenedor: la prueba de que funciona
La forma más rápida de confirmar que Docker quedó bien instalado es correr el contenedor de prueba oficial:
docker run --rm hello-worldDocker descarga una imagen minúscula, la ejecuta, imprime un mensaje de bienvenida y borra el contenedor al terminar (eso hace --rm). Si ves el texto "Hello from Docker!", el motor, la descarga de imágenes y la ejecución funcionan.
Ahora algo un poco más real: un servidor web Nginx.
docker run -d --name web -p 8080:80 --restart unless-stopped nginx:alpine
docker ps
docker logs web-d lo deja corriendo en segundo plano, -p 8080:80 publica el puerto 80 del contenedor en el 8080 del servidor, y --restart unless-stopped hace que vuelva a levantarse tras un reinicio. Abre http://IP-DE-TU-VPS:8080 y verás la página de bienvenida de Nginx. Para entender contenedores, volúmenes y redes en profundidad, revisa la guía completa de Docker en un VPS.
Errores típicos al instalar Docker
La mayoría de los problemas al instalar Docker no son fallos del motor, sino descuidos que se repiten. Esta tabla resume los más comunes y cómo reconocerlos:
| Síntoma que ves | Causa real | Solución |
|---|---|---|
permission denied al correr docker sin sudo | Tu usuario no está en el grupo docker | sudo usermod -aG docker $USER y reinicia sesión |
docker-compose: command not found | Usas la sintaxis antigua con guion | Usa docker compose (con espacio) |
Cannot connect to the Docker daemon | El servicio no está arrancado | sudo systemctl enable --now docker |
| Conflictos de paquetes al instalar | Ya tenías docker.io o Snap instalado | Desinstala lo viejo antes del repositorio oficial |
no space left on device con el tiempo | Imágenes y logs viejos llenan el disco | docker system df y limpieza por nombre |
| El puerto sigue abierto pese a UFW | Docker esquiva UFW (ver más abajo) | Publica en 127.0.0.1 y usa el firewall del proveedor |
El error que más frustra es el primero: instalas Docker, escribes docker ps y te rebota con "permission denied". No está roto; simplemente falta el paso del grupo y volver a iniciar sesión.
Cómo un agente de IA instala Docker por ti
Todo lo anterior lo puede hacer un agente de inteligencia artificial en tu lugar. En los VPS de Terranode viene incluido Cortex AI, un agente que se conecta a tu servidor por SSH y ejecuta comandos cuando se lo pides en español. Le escribes "instálame Docker y Docker Compose" y él recorre la secuencia completa: añade la llave GPG y el repositorio oficial, instala el motor y los plugins, arranca el servicio, configura los permisos de tu usuario y corre la prueba hello-world para confirmar que todo quedó bien.
La diferencia con pegarle la pregunta a un chatbot genérico es que Cortex está conectado a tu máquina: lee qué distribución tienes, detecta si había una instalación previa que da conflicto y verifica el resultado real en lugar de darte instrucciones a ciegas. Es la diferencia entre recibir un mapa y que alguien conduzca contigo.
No es una caja negra que hace cosas por su cuenta. Antes de cualquier acción con consecuencias, el agente se detiene y te pide confirmación mostrándote el comando exacto que va a ejecutar; instalar un paquete o leer un log fluyen solos, pero lo que pueda romper algo espera tu visto bueno. Una política de seguridad bloquea los comandos destructivos, cada acción queda en un registro que puedes consultar, la llave SSH se guarda cifrada con AES-256 y cada cliente está aislado del resto. Cortex AI funciona solo sobre Linux —Ubuntu, Debian, Rocky Linux, AlmaLinux y CentOS— que es justo donde vive Docker.
Así se ve la comparación entre hacerlo tú y delegarlo:
| Tarea | A mano por SSH | Con Cortex AI |
|---|---|---|
| Encontrar los comandos correctos | Buscar y filtrar tutoriales | El agente ya usa el método oficial |
| Detectar una instalación previa en conflicto | Manual, si te acuerdas de mirar | Lo revisa antes de instalar |
| Configurar permisos y verificar | Varios pasos, fácil olvidar uno | Incluidos en la misma orden |
| Registro de lo que se hizo | Lo que anotes tú | Historial completo consultable |
| Aprender en el proceso | Sí, a golpes | Sí: ves cada comando antes de aprobarlo |
Puedes leer más sobre Cortex AI y cómo administra tu VPS, o sobre el enfoque general de administrar un servidor Linux con IA y de los VPS con inteligencia artificial.
El detalle de seguridad que casi nadie te cuenta: Docker y UFW
Docker puede saltarse tu firewall UFW sin avisarte. Cuando publicas un puerto con -p 8080:80, Docker inserta sus propias reglas de iptables por debajo de UFW, así que ese puerto puede quedar accesible desde internet aunque ufw status te muestre el firewall "cerrado". Mucha gente expone sin querer una base de datos o un panel de administración por confiar en que UFW lo tapaba.
La defensa es sencilla y hay que aplicarla desde el primer contenedor:
- Publica los servicios internos enlazados a loopback:
-p 127.0.0.1:8080:80. Así solo son accesibles desde el propio servidor. - Pon un Nginx o Traefik delante para lo que sí deba salir a internet, con HTTPS.
- Usa el firewall del proveedor (a nivel de red) además de UFW.
- Comprueba siempre desde una red externa si un puerto quedó realmente cerrado.
Si le pides a Cortex AI que levante un servicio, aplica este criterio por defecto en lugar de dejarlo abierto a todo el mundo, que es precisamente el tipo de descuido que un agente con criterio de administrador evita.
Instalar Docker y Docker Compose en un VPS Linux se reduce a tres cosas: usar el repositorio oficial, dar permisos a tu usuario con cuidado y probar con hello-world antes de desplegar nada serio. Los errores clásicos —permisos, la sintaxis vieja de Compose, el firewall que no protege— son fáciles de evitar cuando sabes que existen. Y si prefieres no memorizar comandos, un agente de inteligencia artificial como Cortex AI hace la instalación completa por ti, te muestra cada paso antes de ejecutarlo y deja registro de todo. La comodidad del contenedor no elimina las responsabilidades del servidor, pero sí las hace mucho más llevaderas.
Hosting con LiteSpeed, NVMe y soporte 24/7 desde $3/mes.