Auto-héberger Unitae sur un VPS en 10 minutes

23 avril 20268 min de lectureAuto-hébergement

Vous voulez savoir exactement où vivent les données de votre assemblée. Pas une promesse d’un hébergeur — vous voulez vous connecter en SSH à la machine et voir la base de données vous-même. Bien. Dans dix minutes, vous aurez une instance Unitae fonctionnelle sur votre propre serveur, derrière votre propre domaine, avec toutes les fonctionnalités déverrouillées. Le code source est sur GitHub sous AGPL-3.0, et la version auto-hébergée est identique à la version gérée.

Ce dont vous avez besoin

Un VPS avec au moins 1 vCPU, 1 Go de RAM et 10 Go de stockage (20 Go conseillés). Un petit VPS OVH ou Scaleway aux alentours de 4-5 €/mois convient (les données restent en France, cohérent avec l’hébergement managé). Ubuntu 22.04 LTS ou Debian 12 recommandé. Un nom de domaine avec un enregistrement A, Docker et Docker Compose installés, et un compte Resend pour les emails (le niveau gratuit suffit). Pour afficher les cartes, il faudra aussi un fichier de fond de carte pour votre région : la documentation explique comment le découper.

Sur votre machine locale, vous n’avez besoin que d’un accès SSH et d’un éditeur de texte. Tout le reste se passe sur le serveur.

Cloner et configurer

Connectez-vous en SSH, clonez le dépôt, copiez le fichier d’environnement. Définissez UNITAE_BASE_URL (ex. https://unitae.votre-assemblee.org). Générez UNITAE_SESSION_SECRET avec openssl rand -hex 32 — il doit faire au moins 32 caractères — et faites de même pour UNITAE_CRON_SECRET. Définissez RESEND_API_KEY pour les emails de réinitialisation et notifications (créez un compte sur resend.com). Choisissez des mots de passe solides pour DB_PASSWORD, DB_RUNTIME_PASSWORD (une autre valeur : c’est celui du rôle soumis au Row-Level Security) et REDIS_PASSWORD. Enfin, pointez la base et Redis vers leurs conteneurs : DB_URL=postgresql://unitae:<DB_PASSWORD>@postgres:5432/unitae et REDIS_HOST=redis.

# Cloner le dépôt
git clone https://github.com/Unitae/unitae.git && cd unitae

# Copier le fichier d’environnement
cp .env.example .env

# Modifier .env avec vos valeurs
nano .env

Démarrer Unitae

Lancez docker compose up -d pour démarrer la pile. Le service migrate applique les migrations puis sort, ensuite web et worker démarrent. Unitae tourne sur le port 8080 — ouvrez-le dans un navigateur et l’assistant d’installation crée votre premier utilisateur et votre assemblée, en initialisant automatiquement les rôles et les gabarits de programmes par défaut. En cas de problème, docker compose logs web affiche les journaux. Problèmes courants : DB_URL mal formé ou UNITAE_SESSION_SECRET manquant.

docker compose up -d

✓ Unitae tourne sur localhost:8080

Ajouter votre domaine et TLS

Caddy est le reverse proxy recommandé — il gère automatiquement les certificats Let’s Encrypt. Le dépôt en fournit un exemple : copiez docker/Caddyfile.example vers docker/Caddyfile, remplacez le domaine par le vôtre, et décommentez le service caddy dans compose.yaml. Pointez votre enregistrement DNS, et HTTPS est actif en quelques minutes.

Ouvrez les ports 80 et 443 dans votre pare-feu, puis retirez la ligne ports du service web dans compose.yaml : un port publié par Docker passe outre le pare-feu, et l’application ne doit plus être joignable qu’à travers Caddy.

Première connexion et configuration

Naviguez vers votre domaine. L’écran de configuration vous guide pour créer votre compte administrateur et configurer votre assemblée. Parcourez la checklist : définissez la structure territoriale, invitez le préposé aux territoires et le secrétaire, créez votre première carte.

Invitez d’autres membres depuis Réglages › Utilisateurs. Chaque invitation envoie un email avec un lien de création de compte. Les membres reçoivent un accès adapté à leur rôle.

Dernière étape, à ne pas oublier : trois tâches planifiées. Sans elles, aucun email de notification ne part. Ajoutez-les à la crontab du serveur (crontab -e), avec votre UNITAE_CRON_SECRET et votre domaine :

# Notifications toutes les 5 minutes, nettoyage et échéances du tableau chaque jour
UNITAE_CRON_SECRET=…
*/5 * * * * curl -s -H "Authorization: Bearer $UNITAE_CRON_SECRET" https://unitae.example.org/cron/process-notifications
0 3 * * * curl -s -H "Authorization: Bearer $UNITAE_CRON_SECRET" https://unitae.example.org/cron/retention
0 7 * * * curl -s -H "Authorization: Bearer $UNITAE_CRON_SECRET" https://unitae.example.org/cron/board-expirations

Maintenir l’instance à jour

Mise à jour en trois commandes : git pull, docker compose pull, puis docker compose up -d — le service migrate applique les migrations avant que web et worker redémarrent. Sauvegardez la base avant chaque mise à jour, et abonnez-vous aux releases GitHub pour être notifié. Pour les sauvegardes, ajoutez un cron quotidien qui exporte PostgreSQL. Conservez au moins sept jours de sauvegardes. Vous avez désormais une instance entièrement vôtre — et si vous contribuez, chaque assemblée utilisant Unitae en bénéficie.

Lire ensuiteComment remplacer Excel pour la gestion des territoires
Prêt à essayer ?14 jours gratuits. Aucune carte bancaire. Sans engagement.
Commencer l’essai gratuit