Portainer CE - Documentación

Bienvenido a la documentación del despliegue de Portainer Community Edition usando Docker Compose.

¿Qué es Portainer?

Portainer es una plataforma de gestión de contenedores ligera y fácil de usar que te permite administrar tus entornos Docker, Kubernetes, y más a través de una interfaz web intuitiva.

Componentes del Stack

Este repositorio despliega Portainer Server con la siguiente configuración:

Servicio Principal

Imagen: portainer/portainer-ce:lts
Contenedor: portainer
Reinicio: Automático (always)

Puertos Expuestos

9443: Interfaz web HTTPS de Portainer (obligatorio)
8000: Túnel TCP para Edge Agents (opcional, no incluido por defecto)

Volúmenes

/var/run/docker.sock:/var/run/docker.sock - Socket Docker para gestión del host
portainer_data:/data - Almacenamiento persistente de configuración y datos

Red

portainer_network - Red dedicada para el stack

Requisitos Previos

Antes de desplegar Portainer, asegúrate de tener:

✅ Docker Engine instalado (versión compatible según requisitos oficiales)
✅ Docker Compose instalado
✅ Usuario con permisos para acceder a /var/run/docker.sock
✅ Puertos 9443 (y opcionalmente 8000) disponibles
✅ SELinux deshabilitado (Linux) o usar flag --privileged si es necesario

Despliegue Rápido

1. Clonar el Repositorio

git clone https://git.ictiberia.com/groales/portainer
cd portainer

2. Revisar Configuración (Opcional)

Edita docker-compose.yml si necesitas personalizar puertos, redes o volúmenes.

Integración con Proxy Inverso: Este repositorio incluye archivos de ejemplo para Traefik y NPM:

docker-compose.override.traefik.yml.example - Para Traefik
docker-compose.override.npm.yml.example - Para NGINX Proxy Manager

Ver Integración con Traefik para más detalles.

3. Levantar el Stack

docker compose up -d

4. Verificar el Estado

docker ps --filter name=portainer

Deberías ver el contenedor portainer en estado Up.

5. Acceder a la Interfaz Web

Abre tu navegador en:

https://<IP-del-servidor>:9443

🔐 Primera vez: Portainer te pedirá crear un usuario administrador.

⚠️ Certificado SSL: Por defecto, Portainer usa un certificado autofirmado. Tu navegador mostrará una advertencia de seguridad. Para producción, configura certificados válidos (ver Configuración SSL).

Próximos Pasos

🌐 Integración con Traefik - Configurar proxy inverso con TLS automático
🌐 Integración con NPM - Configurar NGINX Proxy Manager
🔌 Edge Agents - Gestionar entornos remotos con agentes Edge

Solución Rápida de Problemas

Problema	Solución
Puerto 9443 ocupado	Cambia el puerto en `docker-compose.yml`: `- "XXXX:9443"`
Contenedor no arranca	Revisa logs: `docker logs portainer`
No se puede conectar	Verifica firewall y que Docker esté corriendo
Error de permisos socket	Añade tu usuario al grupo `docker`: `sudo usermod -aG docker $USER`

Recursos Oficiales

Versión: Portainer CE LTS
Última actualización: Noviembre 2025