Guide de déploiement

Comment auto-héberger Docmost sur un VPS

Déployer sur un VPS Cloud →

Self-hosting3 min de lecture

Comment auto-héberger Docmost sur un VPS

Docmost est un wiki collaboratif open source conçu pour les équipes qui veulent une alternative à Notion et Confluence sans tarification par utilisateur ni données qui quittent leur infrastructure. Édition collaborative en temps réel, diagrammes Mermaid et Draw.io intégrés, pages imbriquées et recherche plein texte — le tout tournant sur trois conteneurs Docker. Voici comment le déployer sur un VPS en moins de 15 minutes.

Pourquoi auto-héberger Docmost plutôt que Notion ou Confluence

Notion et Confluence sont pratiques, mais ils s'accompagnent de compromis qui pèsent pour les équipes de développement : une tarification par utilisateur qui augmente avec les effectifs, des documents hébergés sur l'infrastructure d'un éditeur SaaS et des restrictions à l'export le jour où vous voudriez partir. Docmost tourne sur votre propre VPS — toutes les pages, pièces jointes et index de recherche restent sur votre serveur. Vous contrôlez la politique de sauvegarde, les règles de rétention et les droits d'accès. Pour les entreprises qui manipulent des données clients ou de la documentation technique interne, ce n'est pas un détail.

Ce que vous offre une instance Docmost auto-hébergée

  • Édition collaborative en temps réel — plusieurs membres de l'équipe sur la même page, zéro conflit, les modifications apparaissent instantanément.
  • Arborescence de pages imbriquées avec réorganisation par glisser-déposer et profondeur illimitée.
  • Blocs Mermaid, Draw.io et Excalidraw intégrés — aucun plugin externe nécessaire pour les diagrammes.
  • Recherche plein texte sur l'ensemble des pages et des pièces jointes.
  • Historique des pages et diff — voyez précisément qui a modifié quoi et revenez en arrière en un clic.
  • Permissions fines : contrôle d'accès au niveau de l'espace de travail, du groupe et de chaque page.
  • Zéro coût par utilisateur — vous ne payez que votre VPS.

Prérequis

Il vous faut un VPS avec au moins 2 Go de RAM (4 Go pour les équipes de 10 personnes et plus), Docker et Docker Compose installés, et un domaine ou sous-domaine pointant vers l'IP de votre VPS. La stack de Docmost tient en trois conteneurs : l'application (Node.js), PostgreSQL 16 et Redis 7. Sur un VPS moderne à 2 vCPU, vous servirez confortablement 20 à 30 éditeurs simultanés.

Déployer Docmost sur votre VPS

01

Installer Docker

Connectez-vous en SSH à votre VPS et lancez curl -fsSL https://get.docker.com | sh pour installer Docker et le plugin Compose en une seule étape. Vérifiez avec docker compose version.

02

Générer les secrets

Lancez openssl rand -hex 32 deux fois — une fois pour APP_SECRET, une fois pour POSTGRES_PASSWORD. Créez /opt/docmost/.env avec APP_URL=https://docs.votre-domaine.com, APP_SECRET=<value>, DATABASE_URL=postgresql://docmost:<pg-pw>@db/docmost et REDIS_URL=redis://redis:6379.

03

Rédiger docker-compose.yml

Créez /opt/docmost/docker-compose.yml avec trois services : docmost (docmost/docmost:latest, port 3000:3000, variables d'environnement issues du .env), db (postgres:16-alpine, POSTGRES_DB=docmost, volume docmost_db) et redis (redis:7-alpine, --appendonly yes, volume docmost_redis). Lancez ensuite docker compose up -d.

04

Configurer le reverse proxy et le SSL

Avec Caddy (le plus simple) : ajoutez docs.votre-domaine.com { reverse_proxy localhost:3000 } à votre Caddyfile et rechargez. Avec Nginx : proxy_pass http://127.0.0.1:3000; dans un bloc server, puis lancez Certbot. Mettez à jour APP_URL dans le .env et redémarrez : docker compose restart docmost.

05

Créer votre espace de travail

Ouvrez l'URL dans votre navigateur, créez le premier compte administrateur et nommez votre espace de travail. Invitez vos collègues par e-mail depuis Paramètres → Membres. Commencez par une page d'accueil, puis construisez votre arborescence de pages — déplacez les pages par glisser-déposer pour les réorganiser à tout moment.

06

Se connecter la première fois

Ouvrez l'URL immédiatement après l'installation : Docmost affiche son écran de configuration initiale, où vous créez l'espace de travail et le compte propriétaire (nom, e-mail, mot de passe). Ce premier compte a tous les droits.

Sauvegardez vos volumes

Toutes les données de Docmost résident dans deux volumes Docker : docmost_db (PostgreSQL) et docmost_data (pièces jointes). Planifiez une sauvegarde quotidienne : docker run --rm -v docmost_db:/data -v /backups:/out alpine tar czf /out/docmost-$(date +%F).tar.gz /data. Stockez-la hors du serveur pour une stratégie de reprise après sinistre complète.

La documentation officielle

Pour la configuration avancée et les options propres à l'outil, référez-vous à la documentation officielle de Docmost. Ce guide couvre la mise en ligne sur VPS ; la doc éditeur reste la référence pour les réglages fins, les mises à jour majeures et les cas d'usage spécifiques.

Hébergez le wiki de votre équipe sur un VPS

Déployez Docmost sur un VPS ServOrbit et gardez le savoir de votre équipe sur votre propre infrastructure — sans tarification par utilisateur, sans dépendance à un éditeur.

Besoin d'aide ?

Parcourez notre centre d'aide et notre FAQ, ou contactez notre équipe — rappel, WhatsApp ou e-mail. Support en français, anglais et arabe.