Héberger Penpot sur un VPS : alternative Figma open-source

Figma et Penpot partagent le même paradigme : design vectoriel dans le navigateur, collaboration en temps réel, composants réutilisables et handoff développeur intégré. La différence fondamentale tient au modèle de données et au contrôle. Figma stocke tout sur ses serveurs, dans un format propriétaire. Penpot s'appuie sur SVG et CSS comme langage de base et tourne sur votre infrastructure : vous décidez où vivent les fichiers, qui s'y connecte et quand vous mettez à jour. Pour une équipe qui auto-héberge déjà son code sur Gitea, sa documentation sur Docmost et sa messagerie sur Mattermost, héberger aussi son outil de design sur ServOrbit est la suite logique. Le prix à payer est l'exploitation : sauvegardes, mises à jour et dimensionnement deviennent votre affaire, et c'est l'objet des sections suivantes.

Penpot est une pile de plusieurs conteneurs. Le Compose publié par le projet déclare, à la version 2.18, huit services : penpot-frontend, penpot-backend, penpot-admin-console, penpot-mcp, penpot-exporter, penpot-postgres, penpot-valkey et penpot-mailpit. Le template ServOrbit en démarre un sous-ensemble selon sa version : le nombre exact se lit avec docker compose ps sur votre VPS. Le tableau ci-dessous donne le rôle de chaque service, tel que le Compose amont le décrit. Un seul port compte pour l'exposition : le frontend écoute en interne sur 8080 et le Compose le publie sur 9001. Placez votre reverse proxy devant ce port et rien d'autre.

La documentation amont ne publie pas de plancher mini pour une petite équipe. Elle indique que 4 CPU et 16 Go de RAM suffisent à servir des milliers d'utilisateurs, et vous autorise à rester prudent dans l'allocation. Côté disque, elle recommande de partir de 50 à 100 Go de base de données avec une taille extensible, ce qui couvre jusqu'à 10 éditeurs, puis environ 5 Go de plus par éditeur supplémentaire. La taille réelle dépend de l'usage et de la complexité des fichiers, pas du nombre de comptes. Notre recommandation éditoriale pour une équipe de quelques personnes : un VPS de 4 Go de RAM avec une limite par service (section mémoire plus bas), ce qui laisse de la marge à l'export de fichiers lourds ; 2 Go conviennent pour un essai. Côté réseau, ouvrez 80 et 443 vers le reverse proxy, jamais 9001 ni 8025 directement. Le corps de requête maximal du Compose est de 367001600 octets (350 Mio) : la directive client_max_body_size de votre proxy doit suivre. Côté poste, la documentation recommande la dernière version stable de Chrome.

Pour l'e-mail, activez enable-smtp dans PENPOT_FLAGS et renseignez sur le backend PENPOT_SMTP_DEFAULT_FROM, PENPOT_SMTP_DEFAULT_REPLY_TO, PENPOT_SMTP_HOST, PENPOT_SMTP_PORT (587 dans l'exemple amont), PENPOT_SMTP_USERNAME, PENPOT_SMTP_PASSWORD et PENPOT_SMTP_TLS. Le Compose amont pointe par défaut vers penpot-mailpit, qui garde les messages en mémoire et les perd à la recréation du conteneur. En production, retirez aussi disable-email-verification, que la documentation déconseille hors essai. Côté fichiers, les images et clips SVG envoyés par les utilisateurs sont stockés par défaut sur le système de fichiers, dans le volume penpot_assets monté sur /opt/data/assets (PENPOT_OBJECTS_STORAGE_BACKEND: fs). Un stockage compatible S3 est possible avec PENPOT_OBJECTS_STORAGE_BACKEND: s3, un bucket, un endpoint optionnel et les variables AWS_ACCESS_KEY_ID et AWS_SECRET_ACCESS_KEY. Depuis la version 2.11.0, les anciens noms PENPOT_STORAGE_ASSETS_* ont été remplacés par PENPOT_OBJECTS_STORAGE_* : si vous reprenez un vieux Compose, renommez-les.

Une instance Penpot a deux états à sauvegarder ensemble : la base PostgreSQL et le volume des fichiers. La documentation amont prévient qu'on ne peut pas copier directement le dossier de données d'un volume Docker et renvoie à la procédure de sauvegarde de volume de Docker. Notre approche : un export logique de la base avec docker exec penpot-penpot-postgres-1 pg_dump -U penpot penpot > penpot.sql, puis une archive du volume des fichiers via un conteneur temporaire qui le monte en lecture. Repérez les noms de volumes avec docker volume ls. Prenez les deux au même moment, sinon la base peut référencer des fichiers absents de l'archive, et testez une restauration sur un autre VPS avant d'en avoir besoin. Pour la mise à jour, fixez la version avec PENPOT_VERSION plutôt que de suivre la dernière image, lancez docker compose -p penpot -f docker-compose.yaml pull puis up -d, et avancez par petites étapes : la documentation déconseille de sauter entre versions éloignées. Au 1er novembre 2026, la dernière version publiée est la 2.18.5. Si vous maintenez votre propre Compose, la 2.18 a ajouté le service penpot-admin-console et la variable PENPOT_ADMIN_CONSOLE_URI sur le frontend et le backend. Sauvegardez toujours avant de mettre à jour.

Le ticket penpot #3299, ouvert en juin 2023, est toujours ouvert et a reçu un message en octobre 2026. Il rassemble des témoignages de consommation de RAM élevée sur des installations Docker : un utilisateur rapporte environ 20 Go occupés après trois à quatre jours sur un serveur de 64 Go, un autre plus de 50 Go demandés par une VM sans utilisateur, un dernier 15 Go pour un seul utilisateur avec un redémarrage du backend toutes les 12 heures. Ce sont des rapports individuels, non reproduits : un membre de l'équipe Penpot répond dans le fil qu'il dispose d'installations Docker à fort trafic sans ce symptôme, et demande un fichier et des traces pour diagnostiquer. Nous ne pouvons donc pas promettre de chiffre de consommation. Ce que nous pouvons dire, c'est comment ne pas laisser un service seul décider : le backend est un processus Java, et sans limite de conteneur la machine virtuelle Java dimensionne son tas d'après la mémoire qu'elle voit, c'est-à-dire celle de l'hôte entier. Une limite par service transforme une dérive silencieuse en redémarrage contrôlé.

Contrairement à ce qu'on lit parfois, Penpot n'importe pas un fichier .fig. Le projet maintient un plugin Figma, « Penpot Exporter », qui convertit un fichier Figma en archive .zip importable. Dans Figma, ouvrez le fichier, puis Resources, Plugins, cherchez « Penpot Exporter » et lancez l'export. Dans Penpot, ouvrez le menu à trois points d'un projet ou des brouillons, choisissez « Import Penpot files » et sélectionnez le .zip. D'après le README du plugin, sont repris les formes de base, vecteurs, frames et sections (des boards dans Penpot), groupes et masques, textes, remplissages, contours, ombres, composants et instances, auto layouts, variants et bibliothèques de couleurs et de typographies. Ne sont pas repris : les réglages de prototypage. Les fichiers très volumineux restent un point difficile, car l'export parcourt chaque nœud sous les limites de l'API Figma, et certains rendus peuvent différer légèrement. Importez d'abord un fichier de test, comparez les composants et les polices, puis migrez le reste. Les polices personnalisées se téléversent dans Penpot.

Penpot ne stocke pas vos designs comme des fichiers texte dans un dépôt : la source de vérité est la base PostgreSQL. En revanche, deux exports se prêtent à Git. L'archive .penpot sert de sauvegarde portable d'un fichier. L'export SVG d'un board produit un texte lisible que vous pouvez commiter dans Gitea, par exemple pour les icônes et illustrations d'un design system. Une pull request affiche alors le diff du SVG, et votre pipeline CI peut détecter une modification inattendue. Cette approche reste une convention d'équipe : elle suppose de re-exporter à chaque changement, ce qu'un script ou une revue de design peut vous rappeler.