Cómo instalar Penpot en Docker - Herramienta de diseño colaborativa autohospedada en Docker
Penpot: Herramienta de diseño colaborativa open source autohospedada en Docker
Diseño y prototipado colaborativo. Alternativa Figma/Sketch open source. Editor vectorial profesional. Diseño tokens. Handoff a código. SVG nativo. Libre y self-hosted.
¿Qué es Penpot?
Penpot es un herramienta de diseño y prototipado colaborativa completamente open source que funciona en navegador, diseñada como alternativa a Figma, Sketch, o Adobe XD. A diferencia de herramientas propietarias, Penpot es 100% self-hostable, libre para usar, y construida sobre estándares web abiertos (SVG, CSS, HTML, JSON).
Arquitectura moderna: Backend Clojure + PostgreSQL. Frontend React/ClojureScript. Comunicación real-time via WebSockets. Todo open source (Mozilla Public License v2).
Características principales: Editor vectorial completo (dibujo, shapes, texto, importar SVG). Colecciones y libraries de componentes reutilizables. Prototipado interactivo con animaciones y transiciones. Design tokens integrados (colores, tipografía, espaciado) con sincronización programática. Inspección pixel-perfect para developers con CSS/SCSS exportable. Colaboración real-time (múltiples usuarios editando simultáneamente). Handoff a código: developers ven medidas, colores, especificaciones directamente. Tier gratuito ilimitado (sin restricción de proyectos/archivos en cloud). Self-hosting: deploy en Docker, Kubernetes, cualquier infraestructura. Autenticación flexible (email/password, Google, GitHub, GitLab, OIDC, LDAP). API REST + webhooks para integraciones custom.
Características principales
Editor vectorial completo
Dibujar, shapes, texto, paths. Herramientas profesionales. SVG nativo.
Colaboración real-time
Múltiples usuarios editando simultáneamente. Cursores visibles. Sincronización baja latencia.
Components & Libraries
Componentes reutilizables. Overrides. Nested components. Versioning.
Design Tokens
Sistema completo de tokens. Colores, tipografía, espaciado. Sincronización programática.
Prototipado interactivo
Flujos interactivos. Animaciones. Transiciones. Sin plugins requeridos.
Developer handoff
Inspect panel pixel-perfect. CSS/SCSS exportable. Medidas, colores, especificaciones.
Self-hosted
Docker, Kubernetes, tu infraestructura. Control total. Soberanía datos.
Tier gratuito ilimitado
Sin límite de proyectos, archivos, miembros en cloud. Raro en design tools.
Open source
Mozilla Public License v2. Código auditable. Customizable. Comunidad.
Multi-plataforma
Web (browser-based). Responsive. Funciona en Windows, Mac, Linux.
Autenticación flexible
Email/password, OAuth (Google, GitHub, GitLab), OIDC, LDAP/SSO.
API + Webhooks
REST API para integraciones. Webhooks para eventos. Extensible.
Requisitos del sistema
- Docker & Docker Compose
- 4-8 GB RAM (Clojure backend + PostgreSQL + Redis)
- 10+ GB espacio disco (BD + archivos diseño)
- Puerto 9001 (frontend, configurable)
- Puerto 6063 (backend, interno)
- PostgreSQL 12+ (incluido en docker-compose)
- Redis (incluido en docker-compose)
- Navegador moderno (Chrome, Firefox, Safari, Edge)
Instalación con Docker Compose
Paso 1: Descargar docker-compose de Penpot
Paso 2: Configurar variables de entorno
Paso 3: Iniciar Penpot
Acceder
http://localhost:9001 - Dashboard Penpot
Paso 4: Crear cuenta admin
- Click "Sign Up"
- Email y contraseña
- Verifica email (si SMTP configurado)
- ¡Listo para diseñar!
Primeros pasos
1. Crear proyecto
- Dashboard → "Create New Project"
- Nombre: "Mi proyecto"
- Crear
2. Crear archivo de diseño
- Dentro del proyecto → "Create New File"
- Aparece canvas blanco
- Listo para diseñar
3. Usar herramientas de dibujo
- Left sidebar: Rectangle, Circle, Text, Line, etc
- Click y arrastra en canvas para dibujar
- Right panel: edita propiedades (color, tamaño, posición)
4. Crear componentes reutilizables
- Dibuja un elemento (ej: botón)
- Right click → "Create component"
- Ahora puedes instanciar ese componente múltiples veces
- Cambios al main = actualiza todas las instancias
5. Usar Design Tokens
- Right panel → "Tokens"
- Define colores, tipografía, espaciado
- Úsalos en diseños
- Cambio en token = actualiza automáticamente
6. Crear prototipo interactivo
- Crea múltiples páginas/frames
- Selecciona elemento → "Interaction"
- Define destino y animación
- Preview (play button) para testear
7. Exportar para developers
- Selecciona elemento
- Right panel → "Inspect"
- Developers ven medidas, colores, CSS
- Copia/pega CSS directamente
8. Invitar colaboradores
- Project Settings → "Members"
- Invita por email
- Asigna rol: Owner, Editor, Viewer
- Colaboran en tiempo real
Casos de uso
- Equipos diseño + desarrollo: Colaboran en tiempo real. Design tokens. Developer handoff perfecto.
- Startups: Herramienta gratuita ilimitada. Self-hosted barato. Control total.
- Agencias: Self-hosted en servidor propio. Multi-cliente. Gobierno datos.
- Empresas con compliance estricto: GDPR, HIPAA, etc. Datos 100% locales. Auditable.
- Design systems: Components + design tokens. Gobernanza. Escala.
- Open source communities: Herramienta libre. Contribuir. Sin vendor lock-in.
HTTPS con Caddy (producción)
Caddyfile
Actualizar .env
Acceso remoto seguro
https://penpot.tudominio.com con HTTPS automático de Caddy
Gestión y mantenimiento
Ver logs
Backup de base de datos PostgreSQL
Restore de backup
Reiniciar servicios
Actualizar a versión más reciente
Monitorear consumo de recursos
Crear usuario admin desde terminal
Comparativa con alternativas
vs Figma
Penpot gana: Self-hosted, gratuito, open source, design tokens mejores. Figma gana: Más features, comunidad masiva, plugins, más polido.
vs Sketch
Penpot gana: Web-based, colaboración, gratuito. Sketch gana: Solo macOS, más plugins, comunidad macOS.
vs Adobe XD
Penpot gana: Gratuito, self-hosted, open source. XD gana: Animaciones avanzadas, prototipos complejos.
vs Webflow/Framer
Penpot gana: Design tokens, no vendor lock-in. Webflow/Framer gana: Deploy automático, más features dev.
Comentarios
Publicar un comentario