> ## Content Index
> Fetch the complete content index at: https://blog.esadax.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# Wiki.js
- URL: https://blog.esadax.com/fr/wikijs-fr-3/
- Published: 2026-11-15T05:13:05.000Z
- Updated: 2026-11-15T05:13:05.000Z
- Author: Esadax 
- Tags: #tr-apps-03-catalog-wikijs, #fr, #mdx-imported, Apps

# Qu'est-ce que Wiki.js?

Wiki.js est un wiki moderne et open-source et une plateforme de gestion des connaissances construite avec Node.js. Il fournit un environnement centralisé pour créer, organiser, modifier et partager de la documentation, des guides techniques, des bases de connaissances internes et du contenu collaboratif.

Conçu pour les particuliers, les équipes de développement et les organisations, Wiki.js combine un puissant éditeur Markdown avec un éditeur visuel flexible, une recherche en texte intégral, une gestion des utilisateurs, des contrôles d'accès et des intégrations avec des fournisseurs d'identité externes.

Le contenu peut être synchronisé avec les dépôts Git, ce qui permet aux équipes de gérer la documentation via des workflows de contrôle de version familiers tout en gardant leur base de connaissances accessible via une interface Web.

Wiki.js 3 introduit une architecture repensée avec une collaboration en temps réel, plusieurs sites wiki, des blocs de contenu dynamiques, des capacités d'édition étendues et une API REST moderne. Il utilise PostgreSQL comme base de données et Node.js comme environnement d'exécution de l'application.

La plateforme est auto-hébergée, hautement extensible et distribuée sous la licence GNU Affero General Public License version 3 (AGPL-3.0).

## Historique de Wiki.js

Wiki.js a été créé à l'origine par Nicolas Giard, également connu sous le nom de NGPixel, et a été développé comme une plate-forme de documentation open source depuis 2017.

Les versions originales ont établi Wiki.js comme une alternative moderne aux moteurs wiki traditionnels, combinant la création de contenu basée sur Markdown, la synchronisation Git, les intégrations d'authentification et une interface personnalisable.

Le projet a évolué à travers ses versions 2.x, introduisant des éditeurs supplémentaires, des fournisseurs de stockage, des modules d'authentification, des intégrations de recherche et des capacités d'administration.

Le 1er novembre 2026, le projet a officiellement publié Wiki.js 3.0 en tant que version stable. Cette version représente une réécriture complète du frontend et du backend, introduisant des améliorations architecturales et fonctionnelles significatives.

Les ajouts majeurs dans Wiki.js 3 incluent:

- Édition collaborative en temps réel.
- Hébergement wiki multi-sites.
- Un éditeur Markdown redessiné basé sur l'éditeur Monaco.
- Un nouvel éditeur visuel.
- Blocs de contenu étendus.
- Un gestionnaire de fichiers intégré.
- Amélioration des autorisations et des workflows d'approbation.
- Une API REST documentée.
- Architecture d'authentification mise à jour.
- Recherche améliorée et intégration PostgreSQL.

Au 14 novembre 2026, la dernière version publiée est Wiki.js 3.3.1.

## Principales caractéristiques de Wiki.js

Wiki.js fournit un ensemble complet de fonctionnalités pour créer et maintenir une documentation collaborative.

- **Éditeur Markdown:** Écrivez de la documentation en utilisant Markdown avec la mise en évidence de la syntaxe, la saisie semi-automatique et les aperçus côte à côte en direct.
- **Éditeur visuel:** Créez et formatez du contenu via une interface d'édition de texte enrichi sans écrire manuellement Markdown.
- **Prise en charge AsciiDoc:** Utilisez AsciiDoc comme format de documentation alternatif.
- **Intégration Git:** Synchronisez le contenu du wiki avec les dépôts Git en utilisant la synchronisation bidirectionnelle.
- **Fournisseurs d'authentification:** Prend en charge les comptes locaux, OpenID Connect, LDAP et l'authentification SAML.
- **Permissions granulaires:** Contrôlez l'accès aux pages individuelles, aux chemins, aux groupes, aux paramètres régionaux et aux sites wiki.
- **Collaboration en temps réel:** Permettre à plusieurs utilisateurs de modifier des documents simultanément.
- **Recherche en texte intégral:** Trouvez des informations dans la documentation à l'aide des fonctions de recherche intégrées.
- **Hébergement multi-sites:** Hébergez plusieurs sites wiki indépendants à partir d'une seule instance Wiki.js.
- **Blocs de contenu:** Intégrez des composants dynamiques tels que des diagrammes, des cartes, des galeries, des infoboxes et d'autres éléments interactifs.
- **Historique des pages:** Suivez les révisions, comparez les modifications et restaurez les versions précédentes.
- **Gestionnaire de fichiers:** Organisez les pages de documentation et les ressources téléchargées dans une interface unifiée.
- **Localisation:** Créer et gérer la documentation en plusieurs langues.
- **Flux de travail d'approbation :** Permettez aux utilisateurs de suggérer des modifications pendant que les réviseurs désignés contrôlent la publication.
- **Commentaires et annotations:** Discutez de pages entières ou de sections spécifiques de la documentation.
- **Audit Logging:** Gardez une trace de l'activité des utilisateurs et des changements administratifs.
- **REST API:** Intégrez Wiki.js avec des applications externes et des workflows d'automatisation.
- **Webhooks:** Envoyez des notifications à des systèmes externes lorsque des événements wiki se produisent.
- **Thèmes personnalisés:** Configurez l'apparence, la mise en page et l'identité visuelle du wiki.
- **Intégration MCP facultative:** Permettre aux agents IA compatibles d'accéder aux informations du wiki et d'effectuer les actions prises en charge sous les autorisations de l'utilisateur connecté.

## Cas d'utilisation

Wiki.js peut être utilisé pour un large éventail de scénarios de documentation et de gestion des connaissances.

Les cas d'utilisation courants incluent:

- **Documentation technique:** Maintenir les instructions d'installation, les références API, la documentation sur l'architecture et les guides de développement.
- **Bases de connaissances internes:** Centralisez les procédures de l'entreprise, les instructions opérationnelles et les connaissances institutionnelles.
- **Collaboration d'équipe:** Permettre aux employés et aux contributeurs de créer et de maintenir une documentation partagée.
- **Documentation informatique:** Organiser les informations d'infrastructure, les diagrammes de réseau, les inventaires de serveurs et les procédures de dépannage.
- **Documentation logicielle:** Maintenir la documentation du projet aux côtés du code source en utilisant la synchronisation Git.
- **Support client:** Créez des centres d'aide consultables, des guides de produits et des questions fréquemment posées.
- **Documentation du projet:** Gérer les spécifications du projet, les notes de développement et les informations de sortie.
- **Wikis d'entreprise:** Créez une ressource interne pour les politiques, la documentation d'intégration et les processus organisationnels.
- **Ressources éducatives:** Publiez des supports de cours, des tutoriels et des ressources d'apprentissage collaboratif.
- **Documentation de recherche:** Organiser les résultats techniques, les notes de recherche et le matériel de référence.
- **Runbooks opérationnels:** Maintenir des procédures pour l'administration du système, la maintenance et la réponse aux incidents.
- **Documentation multi-services:** Des espaces de documentation distincts pour différentes équipes ou unités opérationnelles.

## Avantages de Wiki.js

- Gestion centralisée des documents.
- Architecture open source et auto-hébergée.
- Plusieurs éditeurs de contenu.
- Documentation basée sur Markdown.
- Synchronisation soutenue par Git.
- Édition collaborative en temps réel.
- Recherche puissante en texte intégral.
- Gestion granulaire des autorisations.
- Plusieurs fournisseurs d'authentification.
- Prise en charge de plusieurs sites wiki indépendants.
- Historique de révision intégré.
- Organisation flexible du contenu.
- Apparence personnalisable.
- Intégration avec des applications externes.
- API REST et prise en charge des webhooks.
- Fonctionnalités d'administration étendues.
- Aucune dépendance à un service de documentation hébergé propriétaire.

## Comment installer Wiki.js

Pour installer Wiki.js via Esadax, procédez comme suit :

1. Achetez Wiki.js via Esadax.
2. Après l'achat, fournissez les détails de configuration de l'application requis.
3. Configurez l'URL de l'application et le compte administrateur.
4. Configurez la connexion à la base de données PostgreSQL.
5. Sélectionnez les paramètres d'accès aux applications et de sécurité requis.
6. Cliquez sur **Déployer** pour lancer l'application.
7. Accédez à Wiki.js via son URL assignée.
8. Connectez-vous en utilisant le compte administrateur.
9. Terminez la configuration initiale de l'application.
10. Configurez les fournisseurs d'authentification, les groupes d'utilisateurs et les autorisations selon vos besoins.
11. Créez votre premier espace de documentation et commencez à ajouter des pages.

Une fois installé, Wiki.js fournit un environnement centralisé pour organiser et publier la documentation.

## Éditeurs de documentation

Wiki.js 3 inclut plusieurs expériences d'édition conçues pour différents types d'utilisateurs et de workflows de documentation.

### Éditeur Markdown

L'éditeur Markdown fournit un environnement d'écriture structuré avec un aperçu en direct.

Il utilise l'éditeur Monaco, le même moteur d'éditeur utilisé par Visual Studio Code, offrant des fonctionnalités telles que:

- Mise en évidence syntaxique.
- Complétion automatique.
- Assistance d'édition en ligne.
- Aperçu du document en direct.
- Raccourcis clavier.
- Mise en forme Markdown.
- Blocs de code et mise en évidence de syntaxe.
- Tableaux et contenu structuré.
- Les expressions mathématiques.
- Définitions de diagramme.

Markdown reste un format de texte brut, ce qui facilite la révision, le transfert et la gestion de la documentation via Git.

### Éditeur visuel

L'éditeur visuel fournit une expérience de texte enrichi pour les utilisateurs qui préfèrent formater le contenu sans écrire Markdown directement.

Il prend en charge les éléments de documentation communs, y compris:

- Rubriques.
- Paragraphes.
- Listes.
- Tableaux.
- Images.
- A gauche.
- Blocs de code.
- Mise en forme des éléments.
- Contenu intégré.

Le contenu créé avec l’éditeur visuel est stocké en utilisant du contenu basé sur Markdown dans les coulisses.

### AsciiDoc Editor

Wiki.js prend également en charge AsciiDoc pour les utilisateurs qui préfèrent sa syntaxe de documentation structurée.

AsciiDoc convient aux manuels techniques, aux guides structurés et aux projets de documentation plus importants.

### Édition collaborative

Wiki.js 3 prend en charge l'édition simultanée par plusieurs utilisateurs.

Les collaborateurs peuvent travailler sur le même document tout en voyant les curseurs et les modifications des autres participants en temps réel.

La fonctionnalité d'édition collaborative est particulièrement utile pour les équipes préparant des spécifications techniques, des rapports d'incidents, de la documentation opérationnelle et des notes partagées.

## Intégration Git et contrôle de version

Une des capacités importantes de Wiki.js est son intégration avec Git.

La synchronisation Git permet d'échanger le contenu de la documentation avec un référentiel externe, ce qui permet de maintenir la documentation parallèlement aux projets logiciels et aux flux de développement.

Wiki.js 3 fournit une synchronisation bidirectionnelle, permettant aux modifications de contenu de se déplacer entre le wiki et le dépôt connecté.

Cela permet aux équipes de:

- Maintenir la documentation dans un dépôt Git.
- Synchroniser les modifications du wiki avec les fichiers contrôlés en version.
- Examinez les modifications apportées à la documentation via des workflows de développement familiers.
- Gardez le contenu Markdown accessible en dehors de l'interface wiki.
- Intégrer la documentation dans les processus de contrôle source existants.
- Maintenir une copie externe de la documentation.

L'intégration Git est particulièrement utile pour les équipes de développement qui utilisent déjà GitHub, GitLab ou d'autres plateformes d'hébergement Git compatibles.

### Flux de travail de synchronisation Git

Un flux de travail typique se compose des étapes suivantes:

1. Configurez une destination de stockage Git prise en charge.
2. Connectez Wiki.js à un dépôt dédié.
3. Configurez le comportement de synchronisation.
4. Créer ou mettre à jour la documentation dans Wiki.js.
5. Autorisez le processus de synchronisation à publier les modifications.
6. Récupérez les modifications du référentiel via le workflow de synchronisation configuré.

Wiki.js peut également synchroniser le contenu avec les destinations de stockage locales et cloud prises en charge.

**Important :** La synchronisation Git doit être traitée comme un mécanisme de synchronisation de contenu, et non comme un remplacement d'une sauvegarde complète de l'application et de la base de données.

## Authentification et gestion des identités

Wiki.js prend en charge plusieurs méthodes d'authentification, permettant aux organisations d'intégrer la plate-forme aux systèmes de gestion des identités existants.

Les méthodes d'authentification prises en charge comprennent:

| Fournisseur              | Description :                                                                   |
| ------------------------ | ------------------------------------------------------------------------------- |
| Authentification locale  | Gérez les comptes utilisateurs directement dans Wiki.js.                        |
| Se connecter avec OpenID | Intégration avec les fournisseurs d'identité compatibles.                       |
| Google                   | Prise en charge de la connexion via les services d'identité Google.             |
| GitHub                   | Autoriser l'authentification via les comptes GitHub.                            |
| LDAP                     | Intégration avec les services d'annuaire LDAP.                                  |
| SAML 2.0                 | Connectez-vous aux fournisseurs d'identité d'entreprise prenant en charge SAML. |

Des intégrations d'authentification supplémentaires peuvent être disponibles via les configurations de fournisseur d'identité prises en charge.

### Se connecter avec OpenID

OpenID Connect fournit un mécanisme d'authentification standard pour connecter Wiki.js à des fournisseurs d'identité compatibles.

Il peut être utilisé avec des services d'identité tels que Keycloak et d'autres plates-formes compatibles OIDC.

### Authentification LDAP

L'intégration LDAP permet aux organisations d'authentifier les utilisateurs par rapport à un service d'annuaire existant.

Ceci est utile pour les entreprises qui gèrent déjà des comptes d'utilisateurs centralisés et des politiques d'accès basées sur l'annuaire.

### Authentification SAML

SAML 2.0 permet à Wiki.js de s'intégrer à l'infrastructure d'authentification unique d'entreprise.

Cela fournit une option d'authentification pour les organisations utilisant des plateformes d'identité centralisées.

### Cartographie de groupe

Les intégrations d'authentification peuvent mapper les utilisateurs dans des groupes Wiki.js.

Cela permet d'associer des informations d'identité externes aux permissions internes du wiki.

## Autorisations et contrôle d'accès

Wiki.js inclut un système de permissions flexible pour contrôler qui peut lire, créer, modifier, gérer et administrer la documentation.

Les administrateurs peuvent définir des groupes et attribuer des autorisations en fonction des besoins de leur organisation.

Les autorisations peuvent être étendues à:

- Pages wiki individuelles.
- Parcours de documentation.
- Groupes d’utilisateurs.
- Pages localisées.
- Sites wiki individuels.
- Fonctions administratives.

Les rôles d'autorisation typiques incluent:

| Rôle           | Permissions typiques                                                           |
| -------------- | ------------------------------------------------------------------------------ |
| Lecteur        | Voir la documentation autorisée.                                               |
| Contributeur   | Créer et modifier des pages autorisées.                                        |
| Examinateur    | Examiner les modifications proposées et approuver la publication.              |
| Manager        | Gérer la documentation dans les domaines assignés.                             |
| Administrateur | Gérer les utilisateurs, les permissions, la configuration et le wiki lui-même. |

Le modèle d'autorisation prend en charge les règles d'accès héritées et explicitement définies.

Cela rend Wiki.js adapté aux environnements où une partie de la documentation est publique tandis que d'autres informations doivent rester restreintes à des équipes spécifiques.

## Gestion de Wiki multi-sites

Wiki.js 3 introduit la prise en charge de l'hébergement de plusieurs sites wiki indépendants via une seule instance d'application.

Chaque site peut avoir sa propre configuration, y compris:

- Nom d'hôte.
- Thème.
- Localisation.
- Configuration de l'authentification.
- Configuration du stockage.
- Éditeurs.
- Structure de la documentation

Les utilisateurs et les groupes peuvent être partagés entre les instances, ce qui simplifie la gestion des identités et des accès.

La fonctionnalité multisite est utile pour les organisations qui ont besoin de bases de connaissances distinctes pour différents services, produits, clients ou unités commerciales.

Par exemple, une organisation pourrait maintenir des sites distincts pour :

- Documentation interne de l’entreprise.
- Documentation technique.
- Soutien à la clientèle.
- Documentation du produit.
- Ressources de l'équipe de développement.

Chaque site peut avoir son propre hostname et sa propre présentation tout en bénéficiant d’une infrastructure applicative partagée.

## Blocs de contenu et documentation dynamique

Wiki.js prend en charge les blocs de contenu qui permettent d'intégrer des éléments dynamiques et interactifs directement dans les pages de documentation.

Au lieu de limiter les pages au texte et aux images, les blocs de contenu permettent de créer des expériences de documentation plus riches.

Voici quelques exemples:

- Infoboxes.
- Galeries d'images.
- Cartes.
- Visionneuses de PDF.
- Index des pages.
- Sections de spoiler.
- Vidéos intégrées.
- Sirène de diagrammes.
- Diagrammes PlantUML.
- Expressions mathématiques KaTeX.
- Diagrammes Draw.io.
- Blocs personnalisés spécifiques à l'application.

Plus de 25 blocs de contenu intégrés sont disponibles dans Wiki.js 3.

Les développeurs peuvent également créer des blocs de contenu personnalisés pour étendre la plate-forme avec des fonctionnalités supplémentaires.

Ceci est utile pour la documentation technique contenant des diagrammes d'architecture, des références interactives, des explications visuelles et des ressources intégrées.

## Historique des pages et gestion des révisions

Wiki.js maintient un historique des modifications de la documentation, permettant aux administrateurs et aux contributeurs de voir comment les pages ont évolué.

Le système de révision fournit des fonctionnalités pour:

- Affichage des révisions précédentes.
- Comparaison des modifications de documents.
- Identifier qui a apporté des modifications.
- Restauration des versions précédentes.
- Examen de l'évolution de la documentation.

Wiki.js 3 introduit également une corbeille pour récupérer les pages supprimées.

Ces fonctionnalités aident à prévenir la perte accidentelle d'informations et offrent une visibilité sur les modifications de la documentation.

Pour les organisations qui maintiennent une documentation opérationnelle ou technique importante, la gestion des révisions est un élément essentiel de la gouvernance des connaissances.

## Commentaires, annotations et workflows d'approbation

Wiki.js 3 offre des fonctionnalités de collaboration et de révision qui aident les équipes à maintenir la qualité de la documentation.

### Commentaires et annotations

Les utilisateurs peuvent discuter de pages entières ou ajouter des annotations à des sections et passages spécifiques.

Il est ainsi plus facile d’identifier les informations obsolètes, de suggérer des corrections et de discuter des détails techniques sans modifier immédiatement le contenu original.

### Suggestions de modification

Les utilisateurs en lecture seule peuvent être autorisés à suggérer des modifications à la documentation.

Les réviseurs autorisés peuvent évaluer ces suggestions et décider de les approuver ou de les rejeter.

### Règles d'approbation

Les administrateurs peuvent définir des politiques d'approbation pour certaines pages et zones de documentation.

Cela prend en charge les flux de publication contrôlés où la documentation doit être examinée avant d'être mise à la disposition des lecteurs.

### Règles de cycle de vie

Les règles de cycle de vie peuvent déclencher des actions basées sur des conditions de documentation.

Par exemple, les administrateurs peuvent configurer des stratégies pour identifier les pages qui n’ont pas été mises à jour pendant une période spécifiée et informer leurs propriétaires qu’un examen est requis.

Ces fonctionnalités sont particulièrement utiles pour la documentation de conformité, les procédures opérationnelles et les bases de connaissances internes.

## Organisme de recherche et de documentation

Wiki.js inclut une recherche intégrée en texte intégral alimentée par PostgreSQL.

Les utilisateurs peuvent effectuer des recherches dans la documentation sans avoir besoin d'une plateforme de recherche distincte.

La fonctionnalité de recherche prend en charge:

- Recherche en texte intégral.
- Résultats de recherche classés.
- Recherche booléenne.
- Filtrage basé sur les tags.
- Découverte de documentation.
- Recherche à travers les pages autorisées.

La plateforme fournit également un gestionnaire de fichiers structuré pour gérer les pages de documentation et les ressources associées.

Les pages et les fichiers peuvent être organisés dans des dossiers, renommés, déplacés et supprimés via l'interface d'administration.

La combinaison de la recherche, de l'organisation des pages, des balises et de la navigation facilite la maintenance des grandes collections de documentation.

## API et automatisation

Wiki.js 3 fournit une API REST documentée en utilisant la spécification OpenAPI.

L'API permet aux applications et scripts externes d'interagir avec les ressources du wiki par programmation.

Les intégrations possibles incluent:

- Publication automatisée de la documentation.
- Systèmes internes de gestion des connaissances.
- Flux de travail CI/CD.
- Systèmes de rapports externes.
- Outils administratifs personnalisés.
- Services de synchronisation de documentation.
- Processus automatisés de gestion de contenu.

L'API peut être utilisée pour construire des intégrations sans obliger les utilisateurs à effectuer chaque opération via l'interface Web.

Wiki.js prend également en charge les webhooks pour notifier les systèmes externes lorsque des événements wiki spécifiques se produisent.

### Intégration de MCP

Wiki.js 3 inclut un serveur optionnel Model Context Protocol (MCP).

Lorsqu'ils sont activés et correctement configurés, les agents IA compatibles peuvent interagir avec le contenu du wiki via des opérations prises en charge.

Selon les permissions, ces opérations peuvent inclure la recherche de pages, la lecture de la documentation et la proposition de modifications.

L'intégration est désactivée jusqu'à ce qu'elle soit explicitement activée et suit les autorisations de l'utilisateur connecté.

Cela permet aux organisations d’introduire la récupération de connaissances assistée par l’IA sans accorder automatiquement aux agents un accès illimité à la plateforme de documentation.

## Sécurité / Administration / Configuration

Wiki.js fournit une interface d'administration pour gérer les paramètres de l'application, les utilisateurs, l'authentification, les autorisations et les politiques de documentation.

Les considérations de sécurité importantes comprennent:

- Activez HTTPS pour l'accès externe.
- Utilisez des informations d'identification d'administrateur solides.
- Restreindre les autorisations administratives.
- Configurez soigneusement les fournisseurs d'authentification.
- Activez l'authentification multifacteur si elle est prise en charge.
- Appliquer des politiques d'accès basées sur les groupes.
- Examinez les autorisations au niveau de la page.
- Gardez les dépendances de l'application à jour.
- Surveillez l'activité administrative grâce à des journaux d'audit.
- Restreindre l'accès aux services de base de données.
- Protégez les informations d'identification du dépôt Git.
- Sauvegardez régulièrement la base de données PostgreSQL.
- Examinez les intégrations externes et l'accès aux API.
- Configurez les en-têtes de proxy de confiance lorsque vous opérez derrière un proxy inverse.

### Authentification à plusieurs facteurs

Wiki.js 3.3 inclut l'application au niveau du groupe de l'authentification à deux facteurs.

Les administrateurs peuvent utiliser cette fonctionnalité pour exiger une authentification renforcée pour des groupes sélectionnés plutôt que de se fier exclusivement à l’inscription volontaire des utilisateurs.

### Audit Logging

Le journal d'audit enregistre l'activité pertinente de l'application.

Les administrateurs peuvent l'utiliser pour examiner les modifications et enquêter sur les actions des utilisateurs.

### Sécurité et proxies inverses

Lors du déploiement de Wiki.js derrière un proxy inverse, les en-têtes transférés requis et le support WebSocket doivent être configurés correctement.

L'application fournit un paramètre de proxy de confiance pour la gestion des informations de demande transférées.

Ceci est important pour un comportement d'authentification correct, la limitation du débit, la journalisation d'audit et la collaboration en temps réel.

## Meilleures pratiques pour Wiki.js

- Utilisez un nom d'hôte dédié pour le wiki.
- Configurez HTTPS avant d'autoriser l'accès externe.
- Utilisez PostgreSQL pour les données d'application.
- Créez un compte de base de données dédié.
- Utilisez des fournisseurs d'identité externes lorsque l'authentification centralisée est requise.
- Organisez les utilisateurs en groupes selon leurs responsabilités.
- Appliquer le principe du moindre privilège.
- Configurez les autorisations au niveau de la page pour la documentation sensible.
- Utilisez la synchronisation Git lorsque le contrôle de version de la documentation est important.
- Configurez une stratégie de sauvegarde distincte pour la base de données et les ressources téléchargées.
- Tester les procédures de restauration des bases de données et des fichiers.
- Utilisez des workflows d'approbation pour la documentation critique.
- Définissez des stratégies de cycle de vie pour les pages fréquemment révisées.
- Tenir à jour la documentation opérationnelle.
- Surveillez la consommation de ressources des applications et des bases de données.
- Examinez régulièrement les journaux d'audit.
- Gardez Wiki.js et ses dépendances à jour.
- Testez les mises à niveau majeures contre une sauvegarde avant de les appliquer à la production.

## Configuration et administration

Après avoir acheté Wiki.js sur **Esadax**, vous pouvez accéder à l'application et configurer ses paramètres disponibles.

L'interface d'administration fournit une gestion centralisée du wiki et de ses fonctionnalités.

Les zones de configuration importantes incluent:

| Zone de configuration     | Description :                                                                         |
| ------------------------- | ------------------------------------------------------------------------------------- |
| Paramètres généraux       | Configurez le nom du site, le nom d'hôte et le comportement général de l'application. |
| Utilisateurs et groupes   | Créez des utilisateurs et organisez-les en groupes d'autorisations.                   |
| Permissions               | Définissez l'accès à la documentation, aux sites et aux fonctions administratives.    |
| Authentification          | Configurez l'authentification locale et les fournisseurs d'identité externes.         |
| Éditeurs                  | Activez et gérez les éditeurs de documentation pris en charge.                        |
| Stockage                  | Configurez la synchronisation Git et les destinations de stockage prises en charge.   |
| Moteur de recherche       | Gérer le comportement de recherche et les capacités d'indexation.                     |
| Navigation                | Configurez la structure de navigation du wiki.                                        |
| Thème                     | Personnalisez l'apparence et la mise en page de l'application.                        |
| Localisation              | Gérer les langues et traductions prises en charge.                                    |
| Configuration du courrier | Configurez la livraison par e-mail pour les notifications d'application.              |
| Webhooks                  | Connectez les événements wiki à des applications externes.                            |
| Sécurité                  | Gérez les stratégies d'authentification et les paramètres de sécurité.                |
| Metrics                   | Configurez la surveillance des applications et les mesures Prometheus.                |
| Gestion du site           | Gérez plusieurs sites wiki hébergés par la même instance.                             |

Les options de configuration disponibles dépendent de la version de Wiki.js installée et des fonctionnalités activées.

## Base de données et stockage persistant

Wiki.js 3 utilise PostgreSQL comme moteur de base de données requis.

Contrairement aux générations précédentes de Wiki.js, la version 3 ne prend plus en charge les moteurs de base de données alternatifs.

La base de données stocke les informations requises par l'application, y compris le contenu du wiki, les comptes utilisateur, les autorisations, la configuration de l'application et d'autres données système.

### Exigences de base de données

Wiki.js 3 nécessite:

| Composante                         | Besoins                        |
| ---------------------------------- | ------------------------------ |
| Base de données                    | PostgreSQL                     |
| Versions prises en charge          | PostgreSQL 17 ou PostgreSQL 18 |
| Extensions requises                | ltree et pg\_trgm              |
| Temps d'exécution de l'application | Node.js 26                     |

Une base de données PostgreSQL et un compte de base de données dédiés doivent être utilisés pour l'application.

### Git et stockage externe

La synchronisation Git fournit un moyen supplémentaire de maintenir la documentation en dehors de la base de données principale.

Wiki.js peut synchroniser le contenu avec les dépôts Git pris en charge et d'autres destinations de stockage.

Le stockage externe est particulièrement utile pour maintenir une documentation Markdown portable et intégrer le contenu du wiki dans les workflows de développement existants.

### Recommandations de sauvegarde

Une stratégie de sauvegarde fiable devrait inclure:

- Sauvegardes de base de données PostgreSQL.
- Images et ressources de documents téléchargés.
- Configuration importante de l'application.
- Dépôts Git externes.
- Tout stockage persistant maintenu séparément.

La synchronisation Git seule ne doit pas être considérée comme une sauvegarde complète de l'installation de Wiki.js.

## Performances et exigences du système

Wiki.js est conçu pour fonctionner sur un large éventail de configurations de serveur.

Ses besoins en ressources dépendent du nombre d'utilisateurs, de la taille de la documentation, de l'activité de recherche, des tâches en arrière-plan et de la charge de travail de collaboration.

Les exigences de base recommandées par la documentation officielle comprennent:

| Ressource                 | IV. Recommandation                     |
| ------------------------- | -------------------------------------- |
| CPU                       | Au moins 1 cœur; 2 ou plus recommandés |
| RAM                       | Au moins 1 Go sous Linux               |
| Stockage des applications | Au moins 1 Go                          |
| Node.js                   | Version 26                             |
| Base de données           | PostgreSQL 17 ou 18                    |
| Réseau                    | Connectivité HTTP et WebSocket         |

Des ressources supplémentaires peuvent être nécessaires pour les installations plus importantes, en particulier lorsque vous hébergez plusieurs sites wiki ou prenez en charge de nombreux utilisateurs simultanés.

### Considérations de performance

Wiki.js utilise des travailleurs en arrière-plan pour des tâches telles que la maintenance, l'indexation de recherche, les webhooks et le rendu de page.

Pour les grandes installations:

- Allouer suffisamment de ressources CPU pour le traitement en arrière-plan.
- Surveillez les performances de PostgreSQL.
- Utilisez un stockage persistant approprié.
- Surveillez les connexions de base de données et l'activité de requête.
- Assurez-vous que les tâches en arrière-plan peuvent se terminer avec succès.
- Configurez le proxy inverse pour les connexions WebSocket.
- Surveillez les mesures d'application.
- Utilisez un déploiement PostgreSQL de taille appropriée pour une haute disponibilité.

## Licences et modèle open source

Wiki.js est publié sous la licence GNU Affero General Public License version 3 (AGPL-3.0).

Le code source est disponible publiquement, et l'application peut être auto-hébergée et personnalisée.

Les organisations peuvent modifier l’application et l’intégrer à leur propre infrastructure tout en respectant les exigences de licence applicables.

Le projet est dirigé par la communauté et fournit une documentation publique, un code source, un suivi des problèmes et des canaux de contribution.

## IV. CONCLUSION

Wiki.js est une plateforme open source complète pour la création de bases de connaissances auto-hébergées et d'environnements de documentation collaboratifs.

Sa combinaison d'édition Markdown, d'édition visuelle, de synchronisation Git, d'intégrations d'authentification, d'autorisations granulaires, de recherche en texte intégral et d'outils d'administration le rend adapté à la fois à la gestion des connaissances personnelles et à la documentation d'entreprise.

Wiki.js 3 étend considérablement la plateforme avec la collaboration en temps réel, l'hébergement multisite, les blocs de contenu dynamique, les workflows d'approbation et une API REST conforme à OpenAPI.

Avec PostgreSQL comme base de données et la prise en charge des fournisseurs d'identité externes, Wiki.js fournit une solution flexible pour les équipes qui souhaitent un contrôle total sur leur infrastructure de documentation.

Qu'il soit utilisé pour la documentation technique, les connaissances internes de l'entreprise, le support client ou les runbooks opérationnels, Wiki.js offre un environnement structuré et extensible pour créer et maintenir les connaissances organisationnelles.

## Ressources officielles

- [Site officiel](https://js.wiki/?ref=blog.esadax.com)
- [Documentation officielle](https://docs.js.wiki/?ref=blog.esadax.com)
- [Démarrage rapide](https://js.wiki/get-started/?ref=blog.esadax.com)
- [Guide d'installation](https://docs.js.wiki/setup/installation?ref=blog.esadax.com)
- [Configuration requise](https://docs.js.wiki/setup/requirements?ref=blog.esadax.com)
- [Annonce de sortie de Wiki.js 3.0](https://js.wiki/blog/2026-wiki-js-3-release/?ref=blog.esadax.com)
- [Dépôt GitHub](https://github.com/requarks/wiki?ref=blog.esadax.com)
- [Versions GitHub](https://github.com/requarks/wiki/releases?ref=blog.esadax.com)
- [Licence](https://github.com/requarks/wiki/blob/main/LICENSE?ref=blog.esadax.com)