Cómo instalar Portainer y gestionar contenedores Docker desde la web

Gestionar decenas de contenedores Docker por línea de comandos se vuelve fricción rápido: olvidas el nombre exacto del contenedor, necesitas recordar las flags de docker run y auditar volúmenes o redes pide comandos compuestos. Portainer resuelve esto ofreciendo una interfaz web que cubre el 90% de las operaciones del día a día — start, stop, logs, exec, creación de stacks docker-compose, gestión de volúmenes nombrados y redes.

Este tutorial es para quien ya tiene Docker corriendo en un servidor Linux (Ubuntu, Debian o similar) y quiere añadir una capa de gestión visual sin reinstalar nada. Vamos a instalar la edición Community (CE), proteger la interfaz con HTTPS autofirmado que el propio Portainer genera, crear el usuario administrador y cubrir las operaciones más comunes. Tiempo estimado: 15 a 25 minutos, dependiendo de la familiaridad con Docker.

La instalación descrita aquí asume un único host Docker — el escenario más común. Si operas múltiples servidores Docker y quieres un panel central, mencionamos al final cómo añadir agentes remotos más adelante.

Prerrequisitos

Parámetros usados a lo largo del tutorial:

Si vas a poner esto en un servidor de producción expuesto a internet, considera también tener un dominio apuntando a la IP del servidor — facilita más adelante cambiar el certificado autofirmado por uno de Let’s Encrypt válido a través de un reverse proxy.

Instalación de Portainer Server

La instalación oficial recomendada usa un contenedor Docker dedicado con un volumen nombrado para persistir configuración y datos. No hace falta clonar repositorio ni compilar nada — la imagen oficial cubre todos los casos.

docker volume create portainer_data

docker run -d \
  -p 9443:9443 \
  -p 8000:8000 \
  --name portainer \
  --restart=always \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v portainer_data:/data \
  portainer/portainer-ce:latest

docker ps --filter "name=portainer"

Primer acceso y creación del admin

Con el contenedor corriendo, abre el navegador y ve a https://IP_DEL_SERVIDOR:9443. El navegador va a alertar sobre certificado no confiable — es lo esperado, Portainer genera un certificado autofirmado en la primera inicialización. Acepta el aviso y continúa.

Operaciones cotidianas

El menú lateral a la izquierda concentra todas las funciones. Las tres áreas que vas a usar más son Containers, Volumes y Networks, todas dentro del endpoint local.

Gestionando contenedores existentes

La lista de contenedores muestra nombre, estado, imagen base, IP interna y puertos expuestos. Cada contenedor tiene acciones inline: start, stop, restart, kill, remove. Haciendo clic en el nombre del contenedor accedes a:

• Logs — tail en vivo de los logs con filtro y auto-scroll. Equivalente a docker logs -f.
• Stats — gráficos de CPU, memoria, red e I/O de disco con refresh cada segundo.
• Console — terminal interactivo dentro del contenedor, equivalente a docker exec -it. Permite elegir el shell (sh, bash) y el usuario.
• Inspect — JSON completo del contenedor, útil para debug de configuración.

Creando contenedores desde la interfaz

La pantalla Add container sustituye a docker run. Los campos cubren todas las flags principales:

• Image: la imagen a usar (puede ser remota tipo nginx:latest o local)
• Always pull the image: equivalente a --pull=always
• Port mapping: lista de mapeos host:container
• Volumes: bind mounts o volúmenes named
• Network: a qué red Docker conectar
• Restart policy: no, on-failure, unless-stopped, always
• Env variables: variables de entorno en pares clave/valor
• Capabilities, runtime, devices: parámetros avanzados en pestañas separadas

Volúmenes y redes

La sección Volumes lista todos los volúmenes nombrados, muestra el driver, tamaño consumido y qué contenedores están usando cada uno. Puedes crear volúmenes nuevos con drivers específicos (local, NFS) y eliminar volúmenes huérfanos con un clic — atajo útil para liberar espacio en disco después de eliminar contenedores de prueba.

La sección Networks muestra las redes Docker (bridge default, host, none y las que crees). La creación soporta drivers bridge y overlay, con opción de definir subnet personalizada y habilitar IPv6.

Verificación de la instalación

Para confirmar que todo está funcionando, haz este test end-to-end:

docker run -d --name test-portainer nginx:alpine

Recarga la pantalla de Containers en Portainer. El contenedor test-portainer debe aparecer en hasta 2 segundos. Haz clic en él, ve a Logs y confirma que ves las líneas de inicialización de nginx. Después usa el botón Remove en Portainer para borrarlo — confirma vía terminal:

docker ps -a | grep test-portainer

La salida debe estar vacía. Si el ciclo completo funcionó, la instalación está validada.

Resolución de problemas

Error “Cannot connect to the Docker daemon”

El socket Docker no está montado correctamente en el contenedor Portainer. Verifica que la flag -v /var/run/docker.sock:/var/run/docker.sock fue usada en el docker run y que el socket existe en el host con ls -la /var/run/docker.sock. En sistemas con SELinux o AppArmor restrictivo, puede ser necesario añadir :z al final del bind (/var/run/docker.sock:/var/run/docker.sock:z).

Puerto 9443 ya en uso

Otro servicio está escuchando en ese puerto. Identifícalo con sudo ss -tlnp | grep 9443 y o detén el servicio conflictivo, o cambia el puerto de Portainer recreando el contenedor con -p 9444:9443 (o cualquier puerto libre). El mapeo interno permanece 9443 — solo el lado del host cambia.

El navegador bloquea el acceso por certificado inválido

Comportamiento esperado en primera instalación debido al certificado autofirmado. En uso real, coloca Portainer detrás de un reverse proxy (nginx o Caddy) con certificado Let’s Encrypt — el proxy hace el TLS público y Portainer responde HTTP interno en la red Docker.

Próximos pasos

Con Portainer corriendo, vale la pena explorar:

1. Crear un Stack con docker-compose para levantar aplicaciones multi-contenedor coordinadas
2. Configurar Templates personales — recetas pre-armadas con variables para acelerar deploys repetitivos
3. Añadir un Agent en un segundo servidor para gestionar múltiples hosts desde el mismo panel
4. Habilitar Registries privados (Docker Hub privado, GitHub Container Registry) en la sección Registries
5. Colocar un reverse proxy con Let’s Encrypt delante para tener HTTPS válido en dominio propio

Si estás corriendo Portainer en producción para gestionar workloads críticos, una VPS Hostini de plan dedicado da CPU dedicada y snapshot rápido — útil para probar updates de Portainer o rollback de stacks que fallen. Mira las opciones en /vps.