Introducción
Docker permite ejecutar aplicaciones y servicios dentro de contenedores aislados en un servidor Linux. En BoxToPlay, este tipo de despliegue es muy útil cuando queremos instalar rápidamente una herramienta, un servicio web o un entorno de pruebas en un VPS.
En este tutorial veremos cómo instalar Docker de forma limpia en una máquina Linux basada en Debian o Ubuntu, comprobar que la instalación funciona y lanzar un primer contenedor de prueba.
1. Requisitos previos
Antes de empezar, asegúrate de tener:
- un servidor Linux basado en Debian o Ubuntu;
- acceso SSH con un usuario que pueda usar
sudo; - una máquina actualizada;
- una conexión a internet activa para descargar los paquetes de Docker.
Ejemplo de salida al actualizar el sistema:
sudo apt update && sudo apt upgrade -y
Ejemplo de salida:
Hit:1 http://archive.ubuntu.com/ubuntu noble InRelease
Get:2 http://security.ubuntu.com/ubuntu noble-security InRelease [126 kB]
...
Reading package lists... Done
Calculating upgrade... Done
2. Eliminar paquetes antiguos de Docker
Antes de hacer una instalación limpia, elimina los paquetes antiguos de Docker que puedan estar presentes. Para este tutorial, usamos la siguiente secuencia oficial:
sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc podman-docker containerd runc | cut -f1)
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
Ejemplo de salida:
Reading package lists... Done
Building dependency tree... Done
Package 'docker.io' is not installed, so not removed
...
# Executing docker install script, commit: ...
+ sh -c apt-get -qq update >/dev/null
+ sh -c DEBIAN_FRONTEND=noninteractive apt-get -y -qq install docker-ce docker-ce-cli containerd.io docker-compose-plugin >/dev/null
Este método instala Docker Engine junto con el plugin moderno de Docker Compose.
3. Verificar la instalación de Docker
Una vez terminada la instalación, comprueba las versiones disponibles:
docker --version
docker compose version
Ejemplo de salida:
Docker version 26.1.0, build ...
Docker Compose version v2.27.0
Si ambos comandos responden correctamente, Docker Engine y Docker Compose están disponibles en la máquina.
4. Iniciar y activar el servicio Docker
En la mayoría de los sistemas, el servicio arranca automáticamente. Aun así, puedes forzar el arranque y confirmar su estado:
sudo systemctl enable --now docker
sudo systemctl status docker --no-pager
Ejemplo de salida:
Synchronizing state of docker.service with SysV service script...
Created symlink /etc/systemd/system/multi-user.target.wants/docker.service -> /lib/systemd/system/docker.service.
● docker.service - Docker Application Container Engine
Active: active (running)
Esta comprobación confirma que Docker también se iniciará automáticamente tras el próximo reinicio del servidor.
5. Lanzar un primer contenedor de prueba
Para confirmar que Docker funciona de verdad, ejecuta el contenedor de prueba hello-world:
sudo docker run hello-world
Ejemplo de salida:
Unable to find image 'hello-world:latest' locally
latest: Pulling from library/hello-world
...
Hello from Docker!
This message shows that your installation appears to be working correctly.
Si aparece este mensaje, tu instalación de Docker está operativa.
6. Usar Docker sin sudo
Por defecto, los comandos Docker suelen ejecutarse con sudo. Si quieres usar Docker con tu usuario actual, añádelo al grupo docker:
sudo usermod -aG docker $USER
newgrp docker
Según tu sesión SSH, puede ser necesario cerrar sesión y volver a entrar para aplicar el cambio correctamente.
7. Actualizar Docker más adelante
Una vez instalado el repositorio de Docker, las futuras actualizaciones pasan por el sistema de paquetes habitual:
sudo apt update && sudo apt upgrade -y
Ejemplo de salida:
Hit:1 http://archive.ubuntu.com/ubuntu noble InRelease
Hit:2 https://download.docker.com/linux/ubuntu noble InRelease
...
Reading package lists... Done
Así mantendrás Docker, su motor y el plugin Compose al día en tu servidor.
Conclusión
Ahora ya tienes un método claro para instalar Docker en Linux, comprobar el servicio, probar un primer contenedor y preparar tu servidor para futuros despliegues. Si quieres realizar esta instalación en una máquina limpia, puedes probar gratis un servidor VPS.