blueprints
Repositorio comunitario de blueprints declarativos para aplicaciones autoalojadas integradas con Pangolin, un proxy inverso con SSO y capacidades VPN.
Ficha actualizada 28 sept 2026, 13:47 · upstream 28 sept 2026, 13:23 · release sin release detectada
Qué es blueprints
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio contiene una biblioteca comunitaria de blueprints listos para usar que exponen aplicaciones comunes a través de Pangolin. Los blueprints son definiciones declarativas que automatizan la creación y configuración de recursos sin intervención manual en el dashboard.
Cada servicio tiene etiquetas predefinidas que crean automáticamente los recursos correspondientes en el dashboard de Pangolin. Esto permite exponer servicios autoalojados en minutos sin configurar proxy inverso, abrir puertos o ajustar configuraciones de red manualmente.
El sistema soporta tanto despliegue en Pangolin Cloud como instalación self-hosted, con autenticación centralizada y gestión simplificada del ciclo de vida mediante CLI.
- Autoalojar aplicaciones comunes (grafana, immich, homepage) con SSO integrado automáticamente
- Desplegar servicios sin configurar proxy inverso manualmente ni exponer puertos directamente
- Gestión centralizada de autenticación para múltiples servicios mediante roles y listas blancas
- Crear nuevos blueprints fácilmente usando el scaffold proporcionado en bin/blueprint new
- Actualizar imágenes de contenedores con comandos simplificados sin tocar archivos Compose
- Integración nativa con Pangolin para SSO y capacidades VPN en una sola plataforma
- Automatización completa mediante labels declarativos que generan configuración automáticamente
- Sistema de autenticación jerárquico con valores globales sobrescribibles por recurso
- CLI intuitiva (bin/blueprint) para inicializar, configurar, desplegar y gestionar servicios
- Soporte para despliegue en Pangolin Cloud o instalación self-hosted sin cambios mayores
- Dependencia completa de Pangolin como proxy inverso; no funciona standalone
- No incluye Dockerfiles propios, utiliza imágenes externas que deben mantenerse actualizadas
- Requiere configuración inicial obligatoria de SITE_ID y SITE_SECRET para autenticación
- Limitado a servicios compatibles con Compose/Docker y definibles mediante labels
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Configurar BASE_DOMAIN, PANGOLIN_ENDPOINT, SITE_ID y SITE_SECRET en .env raíz. Usar bin/blueprint init <service> para inicializar cada blueprint. Verificar configuración con bin/blueprint config <service> antes de desplegar. Para despliegue self-hosted, cambiar PANGOLIN_ENDPOINT a la URL del dashboard local.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.