Alojar Penpot en un VPS: alternativa a Figma open-source

Figma y Penpot comparten el mismo paradigma: diseño vectorial en el navegador, colaboración en tiempo real, componentes reutilizables y entrega a desarrollo integrada. La diferencia fundamental está en el modelo de datos y en el control. Figma guarda todo en sus servidores, en un formato propietario. Penpot se apoya en SVG y CSS como lenguaje base y funciona en su infraestructura: usted decide dónde viven los archivos, quién se conecta y cuándo actualiza. Para un equipo que ya autoaloja su código en Gitea, su documentación en Docmost y su mensajería en Mattermost, alojar también la herramienta de diseño en ServOrbit es la continuación lógica. El precio es la operación: copias de seguridad, actualizaciones y dimensionamiento pasan a ser cosa suya, y de eso tratan las secciones siguientes.

Penpot es una pila de varios contenedores. El Compose publicado por el proyecto declara, en la versión 2.18, ocho servicios: penpot-frontend, penpot-backend, penpot-admin-console, penpot-mcp, penpot-exporter, penpot-postgres, penpot-valkey y penpot-mailpit. La plantilla de ServOrbit arranca un subconjunto según su versión: el número exacto se lee con docker compose ps en su VPS. La tabla siguiente da el papel de cada servicio tal como lo describe el Compose original. Solo un puerto cuenta de cara a la exposición: el frontend escucha internamente en el 8080 y el Compose lo publica en el 9001. Ponga su proxy inverso delante de ese puerto y de ningún otro.

La documentación original no publica un mínimo para un equipo pequeño. Indica que 4 CPU y 16 GB de RAM bastan para servir a miles de usuarios y permite ser prudente al asignar recursos. En disco, recomienda partir de 50 a 100 GB de base de datos con tamaño elástico, lo que cubre hasta 10 editores, y después unos 5 GB más por editor adicional. El tamaño real depende del uso y de la complejidad de los archivos, no del número de cuentas. Nuestra recomendación editorial para un equipo de pocas personas: un VPS de 4 GB de RAM con un límite por servicio (sección de memoria más abajo), que deja margen para exportar archivos pesados; 2 GB bastan para una prueba. En red, abra el 80 y el 443 hacia el proxy inverso, nunca el 9001 ni el 8025 directamente. El cuerpo máximo de petición del Compose es de 367001600 bytes (350 MiB): la directiva client_max_body_size de su proxy debe acompañarlo. En el puesto de trabajo, la documentación recomienda la última versión estable de Chrome.

Para el correo, active enable-smtp en PENPOT_FLAGS e indique en el backend PENPOT_SMTP_DEFAULT_FROM, PENPOT_SMTP_DEFAULT_REPLY_TO, PENPOT_SMTP_HOST, PENPOT_SMTP_PORT (587 en el ejemplo original), PENPOT_SMTP_USERNAME, PENPOT_SMTP_PASSWORD y PENPOT_SMTP_TLS. El Compose original apunta por defecto a penpot-mailpit, que guarda los mensajes en memoria y los pierde al recrear el contenedor. En producción, retire también disable-email-verification, que la documentación desaconseja fuera de las pruebas. En cuanto a los archivos, las imágenes y clips SVG que suben los usuarios se guardan por defecto en el sistema de archivos, en el volumen penpot_assets montado en /opt/data/assets (PENPOT_OBJECTS_STORAGE_BACKEND: fs). Es posible un almacenamiento compatible con S3 con PENPOT_OBJECTS_STORAGE_BACKEND: s3, un bucket, un endpoint opcional y las variables AWS_ACCESS_KEY_ID y AWS_SECRET_ACCESS_KEY. Desde la versión 2.11.0, los antiguos nombres PENPOT_STORAGE_ASSETS_* se sustituyeron por PENPOT_OBJECTS_STORAGE_*: si reutiliza un Compose antiguo, renómbrelos.

Una instancia de Penpot tiene dos estados que respaldar juntos: la base PostgreSQL y el volumen de archivos. La documentación original advierte de que no se puede copiar directamente la carpeta de datos de un volumen Docker y remite al procedimiento de copia de volúmenes de Docker. Nuestro enfoque: una exportación lógica de la base con docker exec penpot-penpot-postgres-1 pg_dump -U penpot penpot > penpot.sql, y luego un archivo comprimido del volumen de archivos mediante un contenedor temporal que lo monta en solo lectura. Localice los nombres de los volúmenes con docker volume ls. Haga ambas copias en el mismo momento, o la base podría referenciar archivos ausentes del archivo comprimido, y pruebe una restauración en otro VPS antes de necesitarla. Para actualizar, fije la versión con PENPOT_VERSION en lugar de seguir la última imagen, ejecute docker compose -p penpot -f docker-compose.yaml pull y después up -d, y avance en pasos pequeños: la documentación desaconseja saltar entre versiones lejanas. A 1 de noviembre de 2026, la última versión publicada es la 2.18.5. Si mantiene su propio Compose, la 2.18 añadió el servicio penpot-admin-console y la variable PENPOT_ADMIN_CONSOLE_URI en el frontend y el backend. Haga siempre una copia antes de actualizar.

La incidencia #3299 de penpot, abierta en junio de 2023, sigue abierta y recibió un mensaje en octubre de 2026. Reúne testimonios de alto consumo de RAM en instalaciones Docker: un usuario cuenta unos 20 GB ocupados tras tres o cuatro días en un servidor de 64 GB, otro más de 50 GB solicitados por una VM sin usuarios, otro 15 GB para un solo usuario con reinicio del backend cada 12 horas. Son informes individuales, no reproducidos: un miembro del equipo de Penpot responde en el hilo que tiene instalaciones Docker con mucho tráfico sin este síntoma y pide un archivo y trazas para diagnosticar. Por tanto no podemos prometer una cifra de consumo. Lo que sí podemos decir es cómo evitar que un servicio decida por sí solo: el backend es un proceso Java y, sin límite de contenedor, la máquina virtual de Java dimensiona su heap según la memoria que ve, es decir, la de todo el anfitrión. Un límite por servicio convierte una deriva silenciosa en un reinicio controlado.

Al contrario de lo que a veces se lee, Penpot no importa un archivo .fig. El proyecto mantiene un plugin de Figma, « Penpot Exporter », que convierte un archivo de Figma en un .zip importable. En Figma, abra el archivo, luego Resources, Plugins, busque « Penpot Exporter » y lance la exportación. En Penpot, abra el menú de tres puntos de un proyecto o de los borradores, elija « Import Penpot files » y seleccione el .zip. Según el README del plugin, se trasladan las formas básicas, los vectores, los frames y secciones (boards en Penpot), los grupos y máscaras, los textos, rellenos, trazos, sombras, componentes e instancias, auto layouts, variantes y bibliotecas de colores y tipografías. No se trasladan los ajustes de prototipado. Los archivos muy voluminosos siguen siendo un punto difícil, porque la exportación recorre cada nodo bajo los límites de la API de Figma, y algunos renderizados pueden diferir ligeramente. Importe primero un archivo de prueba, compare componentes y fuentes, y después migre el resto. Las fuentes personalizadas se suben a Penpot.

Penpot no guarda sus diseños como archivos de texto en un repositorio: la fuente de verdad es la base PostgreSQL. Sin embargo, dos exportaciones encajan con Git. El archivo .penpot sirve de copia portátil de un archivo. La exportación SVG de un board produce texto legible que puede subir a Gitea, por ejemplo para los iconos e ilustraciones de un sistema de diseño. Una pull request muestra entonces el diff del SVG y su pipeline de CI puede detectar un cambio inesperado. Este enfoque sigue siendo una convención de equipo: supone volver a exportar tras cada cambio, algo que un script o una revisión de diseño pueden recordarle.