Instala Docker Engine y el plugin Compose desde el repositorio oficial en un VPS con Ubuntu 24.04 y comprueba que funciona con un contenedor de prueba.
Docker convierte tu VPS en una máquina donde cada aplicación corre en su contenedor, con sus dependencias, sin pisar a las demás. Instalarlo desde el repositorio oficial lleva cinco minutos y te asegura versiones al día.
Antes de empezar
- Para quién es este manual. Para un VPS autogestionado (no administrado), donde el sistema y el software los instalas y los mantienes tú. Si tu VPS es administrado, no sigas estos pasos: la plataforma la instalamos nosotros bajo consulta y acuerdo previo, y mantenemos el sistema operativo y el servidor; pídelo por ticket (Cómo abrir un ticket de soporte y que se resuelva a la primera). En administrado y gestionado, además, operamos la plataforma dentro del alcance acordado. En las tres modalidades, tu aplicación y sus despliegues siguen siendo tuyos o de tu desarrollador (¿Cúal es la diferencia entre un VPS administrado y un VPS no administrado?).
- Un VPS con Ubuntu 24.04 LTS recién instalado (Cómo reinstalar el sistema operativo de tu VPS) y acceso SSH como
root(Copias de seguridad, instantáneas y clave SSH en tu VPS). Los comandos valen igual para Ubuntu 26.04; en Debian cambia solo la URL del repositorio (debianen vez deubuntu). - Al menos 2 GiB de memoria. Con 4 GiB vas holgado para construir imágenes en el propio servidor.
- No instales el paquete
docker.iode Ubuntu ni eldockerde Snap: van por detrás y les falta el plugin Compose.
Paso a paso
- Entra por SSH y actualiza el índice de paquetes e instala lo necesario para añadir repositorios firmados:
apt-get update
apt-get install -y ca-certificates curl
- Añade la clave de firma de Docker:
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
- Añade el repositorio oficial. El comando detecta solo la arquitectura y la versión de Ubuntu:
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" > /etc/apt/sources.list.d/docker.list
apt-get update
- Instala Docker Engine, la interfaz de línea de comandos, containerd y los plugins de Buildx y Compose:
apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
- Comprueba las versiones. Docker arranca solo al instalarse y queda activado en cada reinicio del servidor:
docker --version
docker compose version
Cómo comprobar que ha funcionado
Ejecuta el contenedor de prueba de Docker:
docker run --rm hello-world
Descarga una imagen diminuta, la ejecuta y muestra un mensaje que empieza por «Hello from Docker!». Si lo ves, Docker descarga imágenes, crea contenedores y los ejecuta: está listo. El siguiente paso es publicar una aplicación de verdad (Cómo publicar una aplicación Go con Docker Compose en tu VPS) o instalar un panel que lo haga por ti (Cómo instalar Dokploy en tu VPS).
Si algo falla
apt-get updatese queja de la firma del repositorio: repite el paso 2; el ficherodocker.asctiene que existir y ser legible (chmod a+r).docker runda «permission denied»: estás con un usuario que no esroot. Añádelo al grupodockerconusermod -aG docker tuusuarioy vuelve a iniciar sesión.hello-worldno descarga: el servidor no sale a Internet. Comprueba concurl -I https://registry-1.docker.ioy revisa el cortafuegos.- El servidor va justo de memoria al construir imágenes: construye en tu ordenador y sube la imagen, o amplía el VPS. Si no lo ves claro, abre un ticket desde tu área de cliente (Cómo abrir un ticket de soporte y que se resuelva a la primera): en un VPS administrado, Docker y el sistema son nuestros; en uno autogestionado te orientamos, pero son tuyos.