Comment héberger soi-même Plane sur un VPS (Guide complet)

Plane est un outil open source de gestion de projet - tickets, cycles, modules et pages, sur le même terrain que Jira et Linear - et l’une des applications auto-hébergées les plus lourdes que l’on puisse installer sur un petit VPS. La Community Edition embarque une pile de treize conteneurs. L’essentiel de ce guide porte donc sur le bon dimensionnement du serveur, pas sur la frappe de docker compose up.

Pourquoi héberger soi-même Plane ?

L’offre hébergée se facture par utilisateur. L’auto-hébergement supprime ce coût et garde l’historique des tickets, les pièces jointes et les données de projet sur une infrastructure que vous maîtrisez - ce qui compte quand le suivi contient des noms de clients, des failles de sécurité ou des éléments de feuille de route non publiés. La Community Edition est sous licence AGPL-3.0 : vous pouvez donc l’exploiter en entreprise sans redevance.

La contrepartie est réelle : les mises à jour, les sauvegardes et l’instance Postgres vous incombent. Si personne dans l’équipe ne veut de ce rôle, la version hébergée est la réponse honnête.

Prérequis

La documentation de Plane énonce clairement les besoins :

• 2 cœurs CPU, x64/AMD64 ou AArch64/ARM64
• 4 Go de RAM au minimum, 8 Go recommandés en production
• Ubuntu, Debian, CentOS ou Amazon Linux 2/2023
• Docker Engine 20.10+ et Docker Compose v2
• Ports 80 et 443 joignables, ainsi qu’un domaine pointant vers le serveur

Ce plancher de 4 Go n’est pas une marge de confort. La pile lance web, admin, space, api, worker, beat-worker, migrator, live, un proxy, plus postgres:15.7-alpine, valkey/valkey:7.2.11-alpine, rabbitmq:3.13.6-management-alpine et minio/minio. Treize conteneurs au repos consomment l’essentiel de 4 Go avant qu’un seul utilisateur ne se connecte.

S’il vous faut encore un serveur, Contabo, Hetzner Cloud et DigitalOcean proposent des offres qui franchissent la barre - voyez le tableau ci-dessous et notre comparatif VPS complet.

Étape 1 : choisir une offre dépassant 4 Go

C’est là que la plupart des installations de Plane échouent. Chez presque tous les hébergeurs, l’offre la moins chère dispose de 1 Go de RAM, soit le quart du minimum documenté par Plane.

Déployez Ubuntu 24.04 LTS, créez un utilisateur non privilégié puis activez le pare-feu :

sudo apt update && sudo apt upgrade -y
sudo adduser plane
sudo usermod -aG sudo plane
sudo ufw allow OpenSSH && sudo ufw allow 80 && sudo ufw allow 443
sudo ufw enable

Étape 2 : installer Docker

Plane exige Compose v2. Installez depuis le dépôt de Docker afin d’obtenir docker-compose-plugin plutôt que le script v1 en fin de vie :

sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo usermod -aG docker $USER

Déconnectez-vous, reconnectez-vous, puis vérifiez la version :

docker compose version

Étape 3 : faire pointer le DNS vers le serveur d’abord

Faites-le avant de lancer l’installeur. Celui-ci demande votre domaine pendant la configuration et l’inscrit dans WEB_URL et CORS_ALLOWED_ORIGINS ; si le DNS ne résout pas encore, l’émission du certificat échoue et vous éditerez ensuite des fichiers d’environnement.

Créez un enregistrement A pour plane.example.com vers l’adresse IP du VPS et attendez qu’il résolve :

dig +short plane.example.com

Étape 4 : lancer l’installeur officiel

Plane distribue un unique script d’installation qui télécharge des images précompilées et écrit un docker-compose.yaml géré :

curl -fsSL https://prime.plane.so/install/ | sh -

Le script demande votre domaine, puis propose Express (valeurs par défaut) ou Advanced (réglage variable par variable). Express convient pour une première installation. À la fin, Plane répond sur les ports 80 et 443, pilotés par LISTEN_HTTP_PORT et LISTEN_HTTPS_PORT.

Une précision sur le dépôt : le docker-compose.yml présent sur GitHub compile chaque service depuis les sources au lieu de télécharger des images. C’est un flux de travail destiné aux contributeurs - une compilation demande bien plus de RAM que l’exécution, et elle échouera ou saturera un VPS de 4 Go. Utilisez l’installeur.

Ouvrez https://plane.example.com et créez le premier compte. Ce compte devient administrateur de l’instance ; le panneau d’administration se trouve sous /god-mode/, où vous configurez le SMTP, les restrictions d’inscription et l’authentification.

Étape 5 : sauvegarder ce qui compte vraiment

Deux éléments contiennent vos données : le volume PostgreSQL et le volume MinIO, qui stocke chaque pièce jointe. Un instantané du VPS couvre les deux, mais un dump de base restaurable de façon sélective vaut son pesant d’or :

docker exec plane-db pg_dump -U plane plane | gzip > plane-$(date +%F).sql.gz

Copiez le dump hors du serveur. Une sauvegarde posée sur le disque que vous sauvegardez n’est pas une sauvegarde.

Comparatif des VPS pour héberger Plane

La tendance saute aux yeux : les hébergeurs américains demandent de 20 à 24 USD pour le palier 4 Go, soit environ trois à quatre fois l’équivalent européen. Pour un suivi de tickets auto-hébergé qui dessert un seul bureau dans une seule région, cet écart est difficile à justifier.

Pour l’ensemble du marché, consultez notre comparatif VPS complet.

Là où les équipes se font piéger

Dimensionner d’après la page produit plutôt que la documentation. Plane ressemble à une application web ; il se comporte comme une petite plateforme. Quatre Go sont le plancher, pas la cible.

Négliger le SMTP. Sans messagerie configurée dans /god-mode/, les invitations n’arrivent jamais et vous ne pouvez ajouter personne à l’espace de travail. Réglez cela avant d’intégrer l’équipe.

Oublier MinIO dans la sauvegarde. Sauvegarder Postgres seul vous rend chaque ticket et chaque commentaire, sans la moindre pièce jointe.

Plane vaut l’effort d’installation si votre équipe vit déjà dans un outil de suivi et préfère ne pas payer par utilisateur. Dimensionnez correctement la machine, déposez les sauvegardes ailleurs, et le service tournera sans faire de bruit.

Pour d’autres projets et conseils d’auto-hébergement, parcourez la liste awesome-selfhosted ou la communauté r/selfhosted.