Portainer (Release 2.39.3 LTS) en Docker - UI de gestión de Docker autohospedada en Docker

Portainer | Docker Management | Docker

Portainer: UI de gestión de Docker y Kubernetes autohospedada en Docker

Panel de control para Docker/Kubernetes. Contenedores, imágenes, volúmenes, networks. Stacks/Compose. GitOps. Multi-usuario. Temas. Ligero. Community Edition gratuita.

¿Qué es Portainer?



Portainer es una UI ligera y potente para gestionar Docker hosts, Docker Swarm, y clusters Kubernetes desde un panel visual. A diferencia de línea de comandos (Docker CLI) que requiere memorizar comandos, Portainer proporciona interfaz gráfica intuitiva para todas las operaciones Docker. Community Edition es completamente gratuito. Business Edition agrega features avanzadas.

Últimas características (v2.42): Gestor visual de contenedores, imágenes, volúmenes, networks. Stacks/Docker Compose. Docker Swarm. Kubernetes completo (manifests, Helm charts, GitOps). Multi-usuario con RBAC. Tema claro/oscuro/high-contrast. Edge agents para ambientes remotos. GitOps con Git sources. Kompose para migrar Compose a Kubernetes. Theme selector rápido en menú usuario. Kubernetes Volumes (PV, PVC, SC). Soporte para private registries. Ligero: corre como single container.

Para SysAdmins/DevOps: Gestiona toda tu infraestructura Docker/Kubernetes desde UI. Sin necesidad de CLI. Perfect para homelabs, startups, empresas.

Características principales

Gestor de contenedores

Ver, crear, iniciar, detener, eliminar, inspecionar. Logs en vivo.

Gestor de imágenes

Listar, pull, push, eliminar. Build desde Dockerfile.

Volúmenes y networks

Crear, gestionar, inspeccionar volúmenes y redes Docker.

Docker Compose/Stacks

Deploy, editar, eliminar stacks. Visualizar estructura.

Docker Swarm

Gestión completa de Swarm clusters.

Kubernetes

Manifests, Helm, GitOps. Soporte completo k8s.

GitOps

Deploy desde Git. Sincronización automática.

Multi-usuario & RBAC

Roles, permisos granulares. Teams.

Edge agents

Gestiona remote hosts desde central.

Temas y UI

Claro/oscuro/high-contrast. Theme selector rápido.

Registries privadas

Gestiona Docker registries. Private registry support.

Ligero y simple

Single container. Bajo overhead. Rápido.

Requisitos del sistema

  • Docker instalado (o Podman)
  • 512 MB - 1 GB RAM (muy ligero)
  • 1 GB - 5 GB espacio disco
  • Puerto 8000 y 9443 (configurable)
  • Docker socket access (/var/run/docker.sock)
  • Navegador moderno (Chrome, Firefox, Safari, Edge)
Ultra ligero: Portainer consume pocos recursos. Perfecta para Raspberry Pi, NAS, homelabs.

Instalación con Docker

Opción 1: Docker Run simple

docker volume create portainer_data docker run -d \ --name portainer \ --restart unless-stopped \ -p 8000:8000 \ -p 9443:9443 \ -v /var/run/docker.sock:/var/run/docker.sock \ -v portainer_data:/data \ portainer/portainer-ce:latest

Opción 2: Docker Compose

cat > docker-compose.yml << 'EOF' version: '3.8' services: portainer: image: portainer/portainer-ce:latest container_name: portainer restart: unless-stopped ports: - "8000:8000" - "9443:9443" volumes: - /var/run/docker.sock:/var/run/docker.sock - portainer_data:/data volumes: portainer_data: EOF docker compose up -d

Acceder

https://localhost:9443 (HTTPS automático)

Primeros pasos

1. Setup inicial

  1. Abre https://localhost:9443
  2. Crea usuario admin: username, password
  3. Selecciona ambiente (Docker local o remoto)
  4. Dashboard aparece

2. Dashboard principal

  1. Overview con stats: containers, images, volumes, networks
  2. Sidebar izquierdo con secciones
  3. Containers, Images, Volumes, Networks, Stacks

3. Gestionar contenedores

  1. Sidebar → Containers
  2. Ves lista de contenedores con estado
  3. Click para ver logs, inspeccionar, parar/iniciar
  4. Click "Add container" para crear nuevo

4. Gestionar imágenes

  1. Sidebar → Images
  2. Ves imágenes disponibles
  3. Pull image desde registry
  4. Inspeciona detalles, tags, etc

5. Deploy stack/Compose

  1. Sidebar → Stacks
  2. Click "Add stack"
  3. Pega archivo docker-compose.yml
  4. Deploy automático

6. Gestionar usuarios y permisos

  1. Arriba a la derecha → Admin panel
  2. Users → Add new user
  3. Role: Admin, Editor, Operator, Viewer
  4. Permisos granulares por resource

7. Cambiar tema

  1. Click en menú usuario (arriba derecha)
  2. Theme selector: Light, Dark, High Contrast
  3. Cambio inmediato sin refresh

8. Conectar ambientes remotos (Edge)

  1. Sidebar → Environments
  2. Add environment → Edge Agent
  3. Instala agent en host remoto
  4. Se conecta automáticamente a Portainer central

Casos de uso

  • Homelabs: Gestión visual de múltiples containers. Sin CLI.
  • SysAdmins: Panel centralizado para varios hosts Docker.
  • Startups: UI para que no-devs vean estado de aplicación.
  • Kubernetes: Cluster management visual.
  • Equipo remoto: Gestiona infraestructura desde cualquier lugar.
  • Learning Docker: Entiende Docker visualmente antes de CLI.
  • Multi-cluster: Portainer Business para múltiples clústers.

HTTPS con Caddy (producción)

Caddyfile

portainer.tudominio.com { reverse_proxy localhost:9443 { transport http { tls_insecure_skip_verify } } }

Acceso remoto seguro

https://portainer.tudominio.com con HTTPS automático de Caddy

Gestión y mantenimiento

Ver logs

docker logs -f portainer

Actualizar Portainer

docker pull portainer/portainer-ce:latest docker compose down docker compose up -d

Reiniciar

docker compose restart portainer

Backup de datos

docker run --rm -v portainer_data:/data -v $(pwd):/backup alpine tar czf /backup/portainer-backup-$(date +%Y%m%d).tar.gz -C /data .

Restore de backup

tar xzf portainer-backup-20260522.tar.gz -C /var/lib/docker/volumes/portainer_data/_data/

Limpiar datos (reset completo)

docker compose down -v docker volume rm portainer_data

Comparativa con alternativas

vs Docker CLI

Portainer gana: UI visual, fácil para no-técnicos, logs/inspect en vivo. CLI gana: Poderoso, scripts, batch operations.

vs Lazydocker

Portainer gana: Multi-host, web, Kubernetes. Lazydocker gana: TUI simple en terminal.

vs Rancher

Portainer gana: Ligero, simple, Community Edition. Rancher gana: Más enterprise, ranching.

vs k3d/k8s UI

Portainer gana: Maneja Docker y K8s. Más simple. K8s gana: Native, más features Kubernetes.

Mejor para: Quien quiera gestionar Docker/Kubernetes sin CLI. Visual, simple, ligero. Community Edition gratuita.

Comentarios

Entradas populares de este blog

Cómo Instalar y configurar SERVIDOR VPN WIREGUARD en MIKROTIK 🔐 #VPN #Wireguard #Mikrotik #RouterOS

Cómo instalar y configurar DSM SYNOLOGY 7.2.2 en PC | Guía completa, instalación, RAID 1, SMB

Cómo INSTALAR y CONFIGURAR OpenVPN en MIKROTIK. Guía completa paso a paso.