Files
wiki/Catalogue-Self-Hosted/apps/app-wiki-js.md
T
2026-06-09 18:40:21 +02:00

6.4 KiB


title: Wiki.js created: 2026-06-07 updated: 2026-06-07 type: app tags: [catalogue, wiki, documentation, collaboration, markdown, nodejs, postgresql, docker] confidence: high contested: false sources: [https://selfh.st/apps/?tag=wiki]

📗 Wiki.js

Wiki moderne et extensible écrit en Node.js, conçu pour remplacer Confluence/Notion en self-hosted. Éditeur WYSIWYG, Markdown, Git backend, SSO, recherche performante et plus de 30 modules.

Métadonnée Valeur
Site web js.wiki
GitHub requarks/wiki
License AGPL-3.0
Langage Node.js / Vue.js
Étoiles 3239
Dernière MAJ 2026-05-29
Catégorie cat-wiki

Description

Wiki.js est une plateforme de wiki open source écrite en Node.js, aujourd'hui en version 2.x (la v3 est en préparation). C'est l'un des projets de wiki self-hosted les plus actifs : plus de 30 000 installations, une communauté fournie, un système de modules varié. Son but est de remplacer les solutions propriétaires comme Confluence, Notion ou DokuWiki (pour les usages modernes) tout en restant installable sur un petit serveur.

L'éditeur supporte Markdown, WYSIWYG, code brut, tableur (basique) et tabulaire, avec prévisualisation temps réel. Le contenu peut être stocké en base PostgreSQL/MySQL/MariaDB/SQLite ou synchronisé avec un dépôt Git (très apprécié des équipes techniques). L'authentification accepte les utilisateurs locaux, LDAP/AD, OAuth2 (Google, GitHub, GitLab, Discord, Microsoft, Auth0, Okta) et SAML. La recherche est native (Lunr.js, hors ligne, dans l'app).

Wiki.js est positionné entre l'outil de documentation technique (type app-docusaurus ou app-mkdocs) et la base de connaissances d'entreprise (type Confluence). Pour un wiki purement Markdown et rapide, app-dokuwiki (PHP) ou app-raneto (Node) restent plus légers. Pour la collaboration temps réel, app-docmost est aujourd'hui plus moderne.

Installation

Option recommandée : Docker Compose

L'image officielle est requarks/wiki:2. La stack officielle inclut PostgreSQL (et anciennement MariaDB). L'image supporte x86_64 et ARM64.

# docker-compose.yml
services:
  db:
    image: postgres:16-alpine
    container_name: wiki-db
    restart: unless-stopped
    environment:
      POSTGRES_DB: wiki
      POSTGRES_USER: wiki
      POSTGRES_PASSWORD: change-moi-ceci
    volumes:
      - db-data:/var/lib/postgresql/data

  wiki:
    image: requarks/wiki:2
    container_name: wiki-js
    restart: unless-stopped
    depends_on:
      - db
    environment:
      DB_TYPE: postgres
      DB_HOST: db
      DB_PORT: 5432
      DB_USER: wiki
      DB_PASS: change-moi-ceci
      DB_NAME: wiki
      # Active le binding sur 0.0.0.0 derrière un reverse proxy
      BIND: 0.0.0.0
    ports:
      - "3000:3000"
    volumes:
      - wiki-data:/wiki/data
      - wiki-assets:/wiki/assets

volumes:
  db-data:
  wiki-data:
  wiki-assets:

Option 2 : Installation manuelle (Node.js)

git clone https://github.com/requarks/wiki.git -b v2 wiki-js
cd wiki-js
npm install
# prérequis : Node 16+, PostgreSQL 12+ ou MariaDB 10.5+
# configurer config.sample.yml → config.yml (DB, port, etc.)
node server

⚠️ Wiki.js 2 ne supporte pas officiellement Node 18+ pour toutes les versions : bien vérifier la matrice de compatibilité sur le dépôt. Pour un usage pérenne, Docker est fortement recommandé.

Configuration

Le panneau d'administration (/admin) est l'endroit principal : on y gère les utilisateurs, groupes, permissions, modules, stockage et thème. La configuration brute se fait aussi dans config.yml (Docker : monté dans /wiki/config.yml).

Modules utiles à activer :

  • Authentification : au moins LDAP pour une entreprise, OAuth2 pour un projet open source.
  • Stockage : Git (GitHub, GitLab, Gitea local) pour versionner les pages.
  • Recherche : le moteur interne suffit pour < 10 000 pages, sinon passer sur Algolia ou Elasticsearch (module).
  • Thème : Dark/Light/Auto, logo, favicon, pied de page.

Alternatives

Open Source

  • app-docusaurus — Plutôt pour publier une doc publique en site statique.
  • app-mkdocs — Générateur statique Python, plus minimaliste.
  • app-docmost — Wiki collaboratif moderne, édition temps réel.
  • app-dokuwiki — Wiki PHP ultra-léger, sans Node ni BDD (le vétéran).
  • app-raneto — Wiki Markdown pur Node, plus minimaliste.
  • app-xwiki — Java, très extensible, pour les très gros besoins entreprise.
  • BookStack — Wiki/docs simple, ergonomique, PHP/MySQL.
  • Outline — Très propre UX, mais Node + Redis + PostgreSQL.

Propriétaires (ce que Wiki.js remplace)

  • Confluence (Atlassian) — Le grand classique entreprise, Wiki.js est une alternative open source crédible.
  • Notion — Pour un wiki d'équipe moderne, Wiki.js + Git fait le job.
  • Slab — Base de connaissances collaborative.
  • Dropbox Paper — Wiki simple en SaaS.
  • Microsoft SharePoint — Wiki d'entreprise.

Sécurité

  • Authentification forte (LDAP, SAML, OAuth2) à privilégier en entreprise ; ne jamais laisser l'inscription libre en production.
  • HTTPS obligatoire : placer Wiki.js derrière un reverse proxy (Caddy, Traefik, Nginx) avec LetsEncrypt.
  • ⚠️ Mises à jour fréquentes à surveiller (sécurité Node.js) : automatiser via Watchtower ou Renovate.
  • ⚠️ Ne pas exposer le port 3000 directement sur Internet : toujours un reverse proxy.
  • Backups : sauvegarder le volume wiki-data (SQLite) et la base PostgreSQL régulièrement.
  • ⚠️ Le module Git peut écrire sur votre dépôt : sécuriser le token (lecture/écriture limitée au wiki).
  • Activer la 2FA pour les comptes admin dès que possible.

Ressources

Pages Liées