🛠️ Guía de Instalación
Guía completa de instalación de Portainer en sistemas Ubuntu/Debian, incluyendo comandos Docker, configuración inicial y verificación del estado del servicio.
Instalación de Portainer en Ubuntu/Debian
1. Guía de Instalación Paso a Paso
Paso 1: Actualizar el sistema e instalar dependencias
sudo apt update && sudo apt upgrade -y
sudo apt install -y apt-transport-https ca-certificates curl software-properties-common
Paso 2: Instalar Docker (si no está instalado)
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
Paso 3: Habilitar e iniciar Docker
sudo systemctl enable docker
sudo systemctl start docker
Paso 4: Crear volumen para datos persistentes de Portainer
sudo docker volume create portainer_data
Paso 5: Instalar Portainer Community Edition
sudo docker run -d -p 8000:8000 -p 9443:9443 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest
Paso 6: Configurar firewall (opcional)
sudo ufw allow 9443/tcp
sudo ufw allow 8000/tcp
sudo ufw reload
2. Comandos CLI precisos y detallados
Comando de instalación completa (script unificado):
#!/bin/bash
# Script de instalación de Portainer en Ubuntu/Debian
# Actualizar sistema
sudo apt update && sudo apt upgrade -y
# Instalar dependencias
sudo apt install -y apt-transport-https ca-certificates curl software-properties-common
# Instalar Docker
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
# Iniciar Docker
sudo systemctl enable docker
sudo systemctl start docker
# Crear volumen para Portainer
sudo docker volume create portainer_data
# Instalar Portainer
sudo docker run -d -p 8000:8000 -p 9443:9443 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest
# Configurar firewall
sudo ufw allow 9443/tcp
sudo ufw allow 8000/tcp
sudo ufw reload
echo "Instalación completada. Accede a https://localhost:9443"
Comandos de gestión de contenedor:
# Ver logs del contenedor
sudo docker logs portainer
# Reiniciar Portainer
sudo docker restart portainer
# Detener Portainer
sudo docker stop portainer
# Iniciar Portainer
sudo docker start portainer
# Eliminar Portainer (manteniendo datos)
sudo docker stop portainer
sudo docker rm portainer
3. Verificación de estado (status)
Verificar estado de Docker:
sudo systemctl status docker
Verificar estado del contenedor Portainer:
sudo docker ps --filter "name=portainer"
Verificar logs en tiempo real:
sudo docker logs -f portainer
Verificar acceso web:
curl -k https://localhost:9443
Comprobación completa de instalación:
#!/bin/bash
# Script de verificación
echo "=== Verificación de Docker ==="
sudo docker --version
sudo systemctl is-active docker
echo "\n=== Verificación de Portainer ==="
sudo docker ps --filter "name=portainer" --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"
echo "\n=== Verificación de puertos ==="
sudo netstat -tlnp | grep -E "(8000|9443)"
echo "\n=== Instalación verificada. Accede a: https://$(hostname -I | awk '{print $1}'):9443"
Acceso inicial
- Abre navegador web
- Visita:
https://<IP_SERVIDOR>:9443 - Crea usuario administrador
- Conecta al entorno Docker local
Nota: Acepta el certificado SSL autofirmado cuando se solicite.