Comment auto-héberger Wiki.js sur un VPS (Guide Complet)

Wiki.js est un logiciel wiki open-source puissant et flexible construit sur Node.js. Il est adapté à un usage personnel et collaboratif, ce qui en fait un choix populaire pour les développeurs et les passionnés de homelab qui cherchent à auto-héberger une plateforme de documentation ou de gestion des connaissances. Ce guide vous accompagnera dans le processus d’auto-hébergement de Wiki.js sur un serveur privé virtuel (VPS). Nous explorerons également l’utilisation de Docker pour une expérience d’installation simplifiée.

Prérequis

Pour suivre ce guide, vous aurez besoin de :

• Un fournisseur de VPS (recommandé : Contabo VPS, Hetzner Cloud, DigitalOcean, Vultr, ou Linode)
• Un nom de domaine (optionnel mais recommandé pour accéder à votre wiki)
• Des connaissances de base en ligne de commande et en Docker

Choisir le bon VPS

Lors de la sélection d’un VPS pour héberger Wiki.js, tenez compte des spécifications suivantes :

Pour des performances optimales, Contabo offre les meilleures ressources pour le prix, ce qui en fait un choix idéal pour héberger Wiki.js.

Étape 1 : Configuration de votre VPS

1. Lancez votre VPS : Choisissez l’un des plans ci-dessus qui correspond à vos besoins et lancez le serveur.

2. Connectez-vous à votre VPS : Utilisez SSH pour vous connecter. Remplacez your_user et your_ip par vos identifiants.

   ssh your_user@your_ip

3. Mettez à jour votre système :

   sudo apt update && sudo apt upgrade -y

4. Installez Docker :

   sudo apt install docker.io -y
   sudo systemctl start docker
   sudo systemctl enable docker

5. Installez Docker Compose :

   sudo apt install docker-compose -y

Étape 2 : Déployer Wiki.js

1. Créez un répertoire pour Wiki.js :

   mkdir ~/wikijs && cd ~/wikijs

2. Créez un fichier docker-compose.yml :

   Utilisez un éditeur de texte pour créer ce fichier :

   version: "3"
   
   services:
     wikijs:
       image: requarks/wiki:latest
       ports:
         - "3000:3000"
       environment:
         - DB_TYPE=postgres
         - DB_HOST=db
         - DB_PORT=5432
         - DB_USER=wikijs
         - DB_PASS=password
         - DB_NAME=wikijs
       depends_on:
         - db
   
     db:
       image: postgres:13
       environment:
         - POSTGRES_USER=wikijs
         - POSTGRES_PASSWORD=password
         - POSTGRES_DB=wikijs
       volumes:
         - pgdata:/var/lib/postgresql/data
   
   volumes:
     pgdata:

   Modifiez les identifiants de base de données selon vos besoins pour votre configuration.

3. Démarrez le service Wiki.js :

   sudo docker-compose up -d

4. Accédez à Wiki.js : Ouvrez votre navigateur et allez à http://your_ip:3000. Suivez les instructions à l’écran pour compléter la configuration.

Étape 3 : Configurer Wiki.js

Une fois installé, vous pouvez configurer Wiki.js selon vos préférences. Vous pouvez le connecter à une base de données externe, configurer l’authentification des utilisateurs et personnaliser les fonctionnalités. Pour les utilisateurs novices, Wiki.js propose une interface qui rend ces tâches simples.

FAQ

1. Quels sont les avantages d’auto-héberger Wiki.js ?

L’auto-hébergement de Wiki.js vous permet de garder le contrôle total sur vos données et votre vie privée. Vous pouvez personnaliser la plateforme selon vos besoins, dimensionner les ressources à votre convenance et éviter le verrouillage par un fournisseur. Cela donne aux développeurs et aux équipes la possibilité de maintenir une base de connaissances cohérente sans être contraints par des services tiers, tout en étant rentable selon les choix d’infrastructure.

2. Puis-je utiliser Wiki.js avec une base de données PostgreSQL existante ?

Oui, Wiki.js prend en charge la connexion à des bases de données PostgreSQL existantes. Pendant la phase de configuration, vous devez spécifier vos identifiants de base de données dans le fichier docker-compose.yml. Assurez-vous que la version de PostgreSQL est compatible avec les exigences de Wiki.js. Vous voudrez également configurer des paramètres supplémentaires pour des performances optimales en fonction des spécifications de votre base de données.

3. Que se passe-t-il si mon VPS tombe en panne ?

Si votre VPS connaît une interruption, Wiki.js ne sera pas accessible, et toutes les modifications ou mises à jour apportées hors ligne peuvent ne pas être sauvegardées. Des sauvegardes régulières sont cruciales. L’utilisation d’un service de sauvegarde ou la configuration de sauvegardes automatisées pour votre base de données PostgreSQL peut protéger vos données. De plus, envisagez d’utiliser des outils de surveillance pour vous alerter sur l’état de votre VPS, vous permettant de réagir rapidement.

Conclusion

L’auto-hébergement de Wiki.js sur un VPS est une approche pratique pour gérer la documentation et la collaboration dans vos projets. En suivant ce guide, vous mettrez en place une plateforme de gestion des connaissances fiable de manière efficace. Pour plus de détails, consultez notre comparaison complète des VPS pour choisir le fournisseur parfait pour vos besoins. Bon hébergement !