Auto-hébergement avec Docmost : Équipes, Espaces & Permissions (2026)

Déployer Docmost sur votre VPS n’est que le début. La vraie valeur vient de la façon dont vous structurez la base de connaissances de votre équipe. Ce guide couvre l’aspect pratique de Docmost pour les équipes : organiser les espaces, configurer les permissions, comprendre les cas d’usage et tirer le meilleur de l’auto-hébergement.

Pourquoi les équipes choisissent Docmost

Docmost a été conçu pour éliminer la lourdeur de Confluence et la dépendance fournisseur de Notion. Pour les auto-hébergeurs, il résout un vrai problème : les équipes d’entreprise ont besoin de docs collaboratifs avec contrôle d’accès, et le marché open-source manquait d’une option soignée avant l’arrivée de Docmost.

Raisons principales pour lesquelles les équipes choisissent Docmost :

• Pas de tarification par siège — votre coût se limite au VPS (~5–6 €/mois)
• Souveraineté des données — tous les docs restent sur votre serveur
• Collaboration en temps réel — curseurs en direct, pas de conflits de sauvegarde
• Structure hiérarchique — pages imbriquées comme dans Notion
• Permissions granulaires — contrôle d’accès à chaque niveau

VPS recommandé pour une utilisation en équipe

Pour une équipe jusqu’à 20 utilisateurs, nous recommandons :

Comprendre la structure de Docmost

Docmost organise le contenu sur trois niveaux :

Workspace
  └── Espace (ex. « Ingénierie », « Produit », « RH »)
        └── Page (ex. « Référence API »)
              └── Sous-page (ex. « Authentification »)

Workspace : Le conteneur de plus haut niveau pour toute votre organisation. Tous les utilisateurs du workspace peuvent se voir mutuellement.

Espaces : Pensez-y comme des départements ou projets. Chaque espace a ses propres membres et permissions. Un utilisateur peut être membre de certains espaces mais pas d’autres.

Pages : Les documents eux-mêmes. Les pages supportent des sous-pages imbriquées pour des hiérarchies de documentation profondes.

Structurer les espaces pour votre équipe

Une bonne structure d’espaces sépare les responsabilités et réduit le bruit. Exemples :

Pour une société de logiciels :

Ingénierie/
  Décisions d'architecture
  Référence API
  Runbooks
Produit/
  Feuille de route
  Specs de fonctionnalités
  Recherche utilisateur
RH/
  Onboarding
  Politiques

Pour une agence :

Interne/
  Processus
  Modèles
Client-NomProjet/
  Briefs
  Livrables
  Notes de réunion

Pour créer un espace dans Docmost :

1. Cliquer sur « Nouvel espace » dans la barre latérale
2. Nommer l’espace et optionnellement définir une icône
3. Définir la visibilité (publique dans le workspace ou privée)
4. Ajouter des membres et attribuer des rôles

Modèle de permissions

Docmost utilise un contrôle d’accès basé sur les rôles à deux niveaux :

Rôles Workspace

• Owner : Admin complet — gère la facturation, les membres et tous les paramètres
• Admin : Peut gérer les membres et les espaces
• Member : Utilisateur standard avec accès aux espaces autorisés

Rôles d’espace

• Admin : Peut gérer les paramètres de l’espace, les membres et toutes les pages
• Editor : Peut créer et modifier des pages
• Viewer : Accès en lecture seule

Définissez un espace en privé et n’ajoutez que les membres pertinents — idéal pour les espaces sensibles comme RH ou Finance.

La collaboration en temps réel en pratique

Docmost utilise la transformation opérationnelle (OT) pour gérer les éditions simultanées :

• Plusieurs utilisateurs voient les curseurs des autres pendant l’édition
• Les modifications se synchronisent immédiatement sans sauvegardes manuelles
• L’historique des pages permet de revenir à n’importe quelle version précédente

Pour un fonctionnement optimal, votre VPS a besoin d’une connexion stable et d’un support WebSocket correct dans la configuration Nginx (les en-têtes Upgrade et Connection sont essentiels).

Intégrations et extensions

Docmost supporte plusieurs intégrations :

• Email SMTP : Pour les invitations et notifications — configurer dans Paramètres > Messagerie
• OIDC/SSO : Connexion à Keycloak, Authentik ou tout fournisseur OIDC
• Domaine personnalisé : Servir Docmost sur votre propre sous-domaine via Nginx
• Webhooks : Déclencher des actions externes lors de créations ou modifications de pages

Cas d’usage

Wiki d’équipe d’ingénierie

Stockez les décisions d’architecture (ADR), runbooks de déploiement, post-mortems d’incidents et documentation API. Les blocs de code et pages imbriquées de Docmost rendent la documentation technique lisible.

Base de connaissances interne

Politiques RH, checklists d’onboarding, manuel de l’entreprise — tout au même endroit, avec accès en lecture pour les employés et accès édition pour les RH.

Documentation de projet

Utilisez un espace par client ou projet. Partagez des liens en lecture seule avec les parties prenantes externes ou réservez l’accès aux équipes internes.

Gestion personnelle des connaissances

Une seule instance Docmost peut servir à une personne voulant un Notion auto-hébergé — moins cher et plus privé que n’importe quelle alternative SaaS.

Conseils de maintenance

• Sauvegardes : Planifiez des sauvegardes pg_dump quotidiennes et stockez-les hors serveur (S3, Backblaze B2, etc.)
• Mises à jour : Exécutez régulièrement docker compose pull && docker compose up -d
• Monitoring : Utilisez Uptime Kuma (également auto-hébergé) pour être alerté en cas de panne
• Vérification des ressources : Consultez docker stats régulièrement à mesure que votre équipe grandit

Mise à l’échelle au-delà d’un VPS

Pour la plupart des équipes de moins de 100 utilisateurs, un seul VPS Hetzner ou Contabo gère la charge confortablement. PostgreSQL est le goulot d’étranglement ; passer à plus de RAM et de stockage NVMe résout la plupart des problèmes de performance.

Pour d’autres guides d’auto-hébergement : selfhostvps.com/en/best/.