Installer Wiki.js en utilisant Podman et Docker Compose sur Debian 12

Wiki.js est un logiciel wiki open-source moderne et puissant. Il est léger, rapide et prend en charge Markdown. Dans ce guide, nous vous montrerons comment installer Wiki.js en utilisant Podman et Docker Compose sur Debian Linux 12.

Prérequis

1. Debian Linux 12 installé et en fonctionnement.
2. Podman Desktop installé en mode sans root.
3. Podman Compose ou Docker Compose installé.

Étape 1 : Activer le socket Podman

Avant d'exécuter des commandes Docker Compose, activez le socket Podman pour la compatibilité :

Démarrez le service de socket Podman :

systemctl --user enable --now podman.socket

Vérifiez que la prise fonctionne :

systemctl --user status podman.socket

Exportez la variable d'environnement Docker Host :

echo 'export DOCKER_HOST=unix:///run/user/$UID/podman/podman.sock' >> ~/.bashrc

source ~/.bashrc

Étape 2 : Créez un fichier Compose Wiki.js

Créez un fichier nommé docker-compose.yml et copiez-y le contenu suivant :

version: "3"

services:
  db:
    image: postgres:15-alpine
    environment:
      POSTGRES_DB: wiki
      POSTGRES_PASSWORD: wikijsrocks
      POSTGRES_USER: wikijs
    logging:
      driver: "none" # Logs disabled
    restart: unless-stopped
    volumes:
      - db-data:/var/lib/postgresql/data

  wiki:
    image: ghcr.io/requarks/wiki:2
    depends_on:
      - db
    environment:
      DB_TYPE: postgres
      DB_HOST: db
      DB_PORT: 5432
      DB_USER: wikijs
      DB_PASS: wikijsrocks
      DB_NAME: wiki
    restart: unless-stopped
    ports:
      - "8081:3000" 

volumes:
  db-data:

Enregistrez et fermez le fichier.

Étape 3 : Démarrer Wiki.js avec Podman

1. Ouvrez un terminal.
2. Accédez au répertoire où vous avez enregistré le fichier docker-compose.yml.
3. Exécutez la commande suivante :

podman-compose up -d

Cette commande va démarrer les conteneurs Wiki.js et PostgreSQL en mode détaché.

Étape 4 : Accédez à Wiki.js dans votre navigateur

Ouvrez votre navigateur web et accédez à http://localhost:8081 depuis votre barre d'adresse. Maintenant, l'installation réelle de Wiki.js va commencer.

Entrez l'identifiant Email de l'administrateur, le mot de passe de connexion pour l'utilisateur administrateur de Wiki.js, l'URL de votre site wiki et cliquez sur INSTALLER. L'identifiant Email sera le nom d'utilisateur.

Cela prendra un moment pour configurer Wiki.js. Une fois l'installation terminée, vous serez redirigé vers la page de connexion de Wiki.js. Entrez votre identifiant Email et le mot de passe que vous avez fourni à l'étape précédente.

C'est tout. Vous pouvez maintenant commencer à concevoir votre page d'accueil ou accéder à la page d'administration et à partir de là, vous pouvez créer toutes les pages nécessaires.

Voici à quoi ressemble la section d'administration de Wiki.js.

Pour commencer avec Wiki.js, consultez la documentation de Wiki.js.

Étape 5 : Gérer les conteneurs

Vérifier les conteneurs en cours d'exécution :

podman ps

Arrêter les conteneurs :

 podman-compose down

Voir les journaux :

podman logs <container-id>

Conclusion

Vous avez installé avec succès Wiki.js en utilisant Podman et Docker Compose sur Debian Linux 12. Cette configuration utilise PostgreSQL comme base de données et fonctionne en mode sans root, ce qui la rend sûre et efficace.