Docmost est un wiki collaboratif publié sous AGPL-3.0. L'édition Community, gratuite, couvre les espaces, l'édition en temps réel, l'historique et la restauration des pages, les commentaires, la recherche plein texte et l'import Markdown, HTML ou Notion. Les fonctions SSO, IA, permissions granulaires par page et import Confluence sont réservées aux éditions Business et Enterprise, facturées 6 $ par siège et par mois en engagement annuel, avec un minimum de dix sièges (tarifs officiels). C'est notre choix pour la documentation d'équipe dans le comparatif des alternatives open source à Notion. Voici l'installation sur un VPS, avec les fichiers et les commandes exacts.

Préparer le serveur#

Connectez-vous en SSH, mettez le système à jour et créez un dossier dédié :

bash
ssh root@votre-ip
apt update && apt upgrade -y
mkdir -p /opt/docmost && cd /opt/docmost

Avant d'ouvrir les ports, faites pointer l'enregistrement DNS A de votre domaine vers l'adresse du VPS, et un AAAA si le serveur a une adresse IPv6. Caddy demandera le certificat au premier démarrage : sans DNS correct, Let's Encrypt renvoie une erreur et Caddy réessaie avec un délai croissant.

Vérifiez que Docker et le plugin Compose répondent :

bash
docker --version
docker compose version

Si l'une des commandes échoue, le script curl -fsSL https://get.docker.com | sh dépanne sur un serveur de test. En production, suivez plutôt la procédure du dépôt APT officiel décrite dans la documentation Docker pour Ubuntu : vous recevrez les mises à jour de sécurité avec apt.

Ouvrez ensuite le pare-feu, en autorisant SSH avant de l'activer pour ne pas vous couper l'accès :

bash
ufw allow OpenSSH
ufw allow 80/tcp
ufw allow 443/tcp
ufw enable
ufw status

Écrire le fichier Docker Compose#

Générez d'abord un secret d'application long et aléatoire. La documentation impose au moins 32 caractères pour APP_SECRET ; openssl rand -hex 32 en produit 64 :

bash
openssl rand -hex 32

Créez ensuite /opt/docmost/docker-compose.yml. Cette configuration reprend celle de la documentation d'installation officielle, avec PostgreSQL 18, Redis 8 et le port applicatif limité à la boucle locale. Remplacez le domaine, le secret et le mot de passe de la base :

yaml
services:
  docmost:
    image: docmost/docmost:latest
    depends_on:
      - db
      - redis
    environment:
      APP_URL: "https://wiki.example.com"
      APP_SECRET: "collez-ici-le-secret-genere"
      DATABASE_URL: "postgresql://docmost:MOT_DE_PASSE@db:5432/docmost"
      REDIS_URL: "redis://redis:6379"
    ports:
      - "127.0.0.1:3000:3000"
    restart: unless-stopped
    volumes:
      - docmost:/app/data/storage

  db:
    image: postgres:18
    environment:
      POSTGRES_DB: docmost
      POSTGRES_USER: docmost
      POSTGRES_PASSWORD: MOT_DE_PASSE
    restart: unless-stopped
    volumes:
      - db_data:/var/lib/postgresql

  redis:
    image: redis:8
    command: ["redis-server", "--appendonly", "yes", "--maxmemory-policy", "noeviction"]
    restart: unless-stopped
    volumes:
      - redis_data:/data

volumes:
  docmost:
  db_data:
  redis_data:

Quelques points à ne pas rater :

  • APP_URL doit contenir le préfixe https://. Docmost s'en sert pour construire les liens des e-mails et pour le drapeau secure du cookie d'authentification.
  • Le mot de passe présent dans DATABASE_URL doit être identique à POSTGRES_PASSWORD. Une différence produit l'erreur password authentication failed for user "docmost" au démarrage.
  • Le volume PostgreSQL pointe vers /var/lib/postgresql, pas vers /var/lib/postgresql/data : l'image PostgreSQL 18 a changé son chemin par défaut. Le chemin ?schema=public est optionnel.
  • Redis tourne avec appendonly yes et noeviction. Sans noeviction, Redis peut supprimer des clés sous pression mémoire et casser l'état de collaboration.
  • Les limites de taille par défaut sont de 50 Mo par fichier envoyé et 200 Mo par archive importée. Elles se règlent avec FILE_UPLOAD_SIZE_LIMIT et FILE_IMPORT_SIZE_LIMIT (variables d'environnement).

Lancez les trois services :

bash
docker compose up -d
docker compose ps
curl -fsS http://127.0.0.1:3000/api/health

Les trois conteneurs doivent être à l'état running et l'endpoint de santé doit répondre. Le premier démarrage prend souvent une minute : Docmost applique ses migrations avant d'accepter les requêtes. Si curl échoue, docker compose logs --tail=100 docmost affiche les erreurs de connexion à PostgreSQL ou à Redis.

Ajouter le HTTPS avec Caddy#

Caddy obtient et renouvelle les certificats Let's Encrypt sans configuration supplémentaire. Installez-le depuis son dépôt officiel, en reprenant les commandes de la page d'installation Caddy :

bash
apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | tee /etc/apt/sources.list.d/caddy-stable.list
chmod o+r /usr/share/keyrings/caddy-stable-archive-keyring.gpg
chmod o+r /etc/apt/sources.list.d/caddy-stable.list
apt update && apt install -y caddy

Remplacez le contenu de /etc/caddy/Caddyfile par :

text
wiki.example.com {
	reverse_proxy 127.0.0.1:3000
}

Validez la syntaxe avant de recharger, puis vérifiez que le service a bien redémarré :

bash
caddy validate --config /etc/caddy/Caddyfile
systemctl reload caddy
systemctl status caddy --no-pager

Ouvrez https://wiki.example.com : l'écran de création de l'espace de travail s'affiche. Le premier compte créé devient propriétaire de l'espace de travail. Caddy gère aussi les WebSockets utilisés par l'éditeur temps réel ; si vous placez un autre proxy devant Docmost, forwardez les en-têtes Upgrade et Connection, sinon l'éditeur passe en lecture seule (guide reverse proxy).

Configurer les e-mails d'invitation#

Sans serveur SMTP, Docmost ne peut pas envoyer les invitations ni les liens de réinitialisation de mot de passe. Ajoutez ces variables au bloc environment du service docmost, avec les identifiants de votre fournisseur :

yaml
      MAIL_DRIVER: "smtp"
      SMTP_HOST: "smtp.example.com"
      SMTP_PORT: "587"
      SMTP_USERNAME: "[email protected]"
      SMTP_PASSWORD: "mot-de-passe-smtp"
      SMTP_SECURE: "false"
      MAIL_FROM_ADDRESS: "[email protected]"
      MAIL_FROM_NAME: "Docmost"

Sur le port 587, SMTP_SECURE reste à false et la négociation STARTTLS se fait pendant la connexion. Sur le port 465, passez-le à true. Appliquez avec docker compose up -d docmost, puis envoyez une invitation vers une adresse externe pour vérifier la délivrabilité. La page Configuration liste aussi les pilotes Postmark et les stockages S3 ou Azure.

Sauvegarder la base et les fichiers chaque nuit#

Un dump SQL seul ne suffit pas, et une archive jamais restaurée peut être inutilisable le jour de la panne. Le script suivant sauvegarde la base et le dossier des pièces jointes, qui contient les images et les PDF déposés dans les pages. Créez /opt/docmost/backup.sh :

bash
#!/usr/bin/env bash
set -euo pipefail
cd /opt/docmost
mkdir -p backups
STAMP="$(date +%F)"
docker compose exec -T db pg_dump -U docmost -d docmost | gzip > "backups/docmost-db-${STAMP}.sql.gz"
docker compose exec -T docmost tar czf - -C /app/data/storage . > "backups/docmost-files-${STAMP}.tar.gz"
find backups -type f \( -name 'docmost-db-*.sql.gz' -o -name 'docmost-files-*.tar.gz' \) -mtime +14 -delete

Rendez-le exécutable, lancez-le une première fois à la main, puis planifiez-le à 3 h du matin :

bash
chmod +x /opt/docmost/backup.sh
/opt/docmost/backup.sh
(crontab -l 2>/dev/null; echo "0 3 * * * /opt/docmost/backup.sh") | crontab -

Vérifiez le résultat : ls -lh /opt/docmost/backups doit afficher deux archives du jour, et gzip -t backups/docmost-db-*.sql.gz doit sortir sans erreur. Conservez quatorze jours localement, mais copiez aussi les archives hors du serveur avec rclone ou restic : un disque défaillant ou un rançongiciel efface la base et ses sauvegardes si elles restent au même endroit.

Restaurez sur une base vide, en arrêtant d'abord l'application pour éviter des écritures pendant l'opération :

bash
cd /opt/docmost
docker compose stop docmost
gunzip -c backups/docmost-db-2026-10-22.sql.gz | docker compose exec -T db psql -U docmost -d docmost
docker compose run --rm --no-deps -T --entrypoint tar docmost xzf - -C /app/data/storage < backups/docmost-files-2026-10-22.tar.gz
docker compose start docmost

La base et les fichiers doivent provenir du même horodatage : un dump de 3 h avec des fichiers de 4 h laisse des liens d'images cassés. Refaites ce test sur un VPS de recette au moins une fois par trimestre, sans écraser la production.

Mettre à jour Docmost#

bash
cd /opt/docmost
./backup.sh
docker compose pull
docker compose up -d --force-recreate docmost

latest peut changer de version mineure sans prévenir. En production, épinglez un tag précis dans le fichier Compose, testez la mise à jour sur une copie, puis changez le tag volontairement. Les migrations de base s'exécutent au démarrage du conteneur et ne sont pas toujours réversibles : lisez les notes de version, gardez le dump de la veille et prévoyez un retour arrière en réinstallant le tag précédent puis en restaurant la base.

Importer depuis Notion ou Confluence#

Pour Notion, exportez l'espace ou les pages en Markdown ou en HTML : Notion produit une archive ZIP. Dans Docmost, ouvrez l'espace cible, cliquez sur le menu ... à côté de « Pages », choisissez « Import pages », puis « Notion » et envoyez le ZIP. Docmost recrée l'arborescence des pages. Testez d'abord sur un espace de recette : les bases de données et les blocs les plus spécifiques demandent parfois une reprise manuelle (import et export).

Pour Confluence, exportez l'espace en HTML depuis les réglages de l'espace, puis utilisez l'import « Confluence ». La mise en forme, l'arborescence, les liens internes, les images et les diagrammes Draw.io sont conservés. Cet import fait partie de l'édition Business ; l'import Notion, Markdown et HTML reste disponible dans l'édition Community.

Si une archive dépasse la limite, augmentez FILE_IMPORT_SIZE_LIMIT (200 Mo par défaut) ou FILE_UPLOAD_SIZE_LIMIT (50 Mo par défaut) dans le bloc environment, puis recréez le conteneur avec docker compose up -d docmost.

Dépannage#

  • 502 Bad Gateway : Docmost n'écoute pas ou le proxy vise le mauvais port. Lancez docker compose ps, puis curl -fsS http://127.0.0.1:3000/api/health. Si le conteneur redémarre en boucle, lisez docker compose logs --tail=200 docmost.
  • Éditeur en lecture seule : les WebSockets sont bloqués. Avec Caddy, reverse_proxy les gère seuls ; avec Nginx ou Traefik, ajoutez le forward des en-têtes Upgrade et Connection.
  • password authentication failed : le mot de passe de DATABASE_URL ne correspond pas à POSTGRES_PASSWORD. Modifier POSTGRES_PASSWORD après la création du volume ne change pas le rôle PostgreSQL existant : corrigez DATABASE_URL ou recréez la base.
  • Certificat absent : vérifiez le DNS avec dig +short wiki.example.com, l'ouverture des ports 80 et 443, puis journalctl -u caddy -n 50 --no-pager.
  • Disque plein : les pièces jointes vivent dans le volume Docker. Surveillez docker system df et du -sh /opt/docmost/backups, et externalisez les archives avant de saturer le VPS.

Questions fréquentes

Combien coûte l'auto-hébergement de Docmost ?

L'édition Community est gratuite. L'édition Business coûte 6 $ par siège et par mois en engagement annuel, avec un minimum de dix sièges, soit 60 $ par mois pour dix personnes ; Enterprise est sur devis. Côté serveur, comptez 5 à 10 € par mois pour un VPS KVM de 2 Go hors promotions, plus 10 à 15 € par an pour le nom de domaine.

Peut-on installer Docmost sur un hébergement mutualisé ?

Non. Docmost a besoin de Docker, de PostgreSQL et de Redis, que les offres mutualisées ne permettent pas de faire tourner. Il faut un VPS ou un serveur dédié.

Comment importer des pages Notion dans Docmost ?

Exportez votre espace Notion en Markdown ou en HTML : l'export est une archive ZIP. Dans l'espace cible, ouvrez « Import pages », choisissez « Notion » et envoyez le ZIP. Les pages et la hiérarchie sont conservées ; les blocs complexes peuvent demander un contrôle manuel.

Comment restaurer une sauvegarde ?

Arrêtez Docmost, restaurez le dump SQL sur une base vide, puis extrayez l'archive des fichiers dans /app/data/storage avec un conteneur jetable : gunzip -c backups/docmost-db-AAAA-MM-JJ.sql.gz | docker compose exec -T db psql -U docmost -d docmost puis docker compose run --rm --no-deps -T --entrypoint tar docmost xzf - -C /app/data/storage < backups/docmost-files-AAAA-MM-JJ.tar.gz. Redémarrez ensuite le service.

Quelle est la différence entre Community et Business ?

Community couvre les pages, les espaces, l'édition temps réel, la recherche plein texte, les commentaires et les imports Markdown, HTML et Notion. Business ajoute le SSO SAML/OIDC/LDAP, l'IA, les permissions granulaires par page, les Bases et Kanban, l'import Confluence et le support par e-mail.

Sources#

Pages officielles consultées le 22 octobre 2026.