Idioma
Español
Documentacion /docs

🛠️ 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

  1. Abre navegador web
  2. Visita: https://<IP_SERVIDOR>:9443
  3. Crea usuario administrador
  4. Conecta al entorno Docker local

Nota: Acepta el certificado SSL autofirmado cuando se solicite.