Wiki.js mit Podman und Docker Compose unter Debian 12 installieren

Wiki.js ist eine moderne und leistungsstarke Open-Source-Wiki-Software. Sie ist leichtgewichtig, schnell und unterstützt Markdown. In diesem Leitfaden zeigen wir Ihnen, wie Sie Wiki.js installieren mit Podman und Docker Compose auf Debian Linux 12.

Voraussetzungen

1. Debian Linux 12 installiert und läuft.
2. Podman Desktop im rootlosen Modus installiert.
3. Podman Compose oder Docker Compose installiert.

Schritt 1: Podman-Socket aktivieren

Bevor Sie Docker-Compose-Befehle ausführen, aktivieren Sie den Podman-Socket zur Kompatibilität:

Starten Sie den Podman-Socket-Dienst:

systemctl --user enable --now podman.socket

Überprüfen Sie, ob die Steckdose läuft:

systemctl --user status podman.socket

Exportiere die Docker-Host-Umgebungsvariable:

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

source ~/.bashrc

Schritt 2: Erstellen Sie eine Wiki.js Compose-Datei

Erstellen Sie eine Datei namens docker-compose.yml und kopieren Sie den folgenden Inhalt hinein:

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:

Speichern und schließen Sie die Datei.

Schritt 3: Starten Sie Wiki.js mit Podman

1. Öffnen Sie ein Terminal.
2. Navigieren Sie zu dem Verzeichnis, in dem Sie die docker-compose.yml-Datei gespeichert haben.
3. Führen Sie den folgenden Befehl aus:

podman-compose up -d

Dieser Befehl startet die Wiki.js- und PostgreSQL-Container im Hintergrundmodus.

Schritt 4: Greifen Sie in Ihrem Browser auf Wiki.js zu

Öffnen Sie Ihren Webbrowser und navigieren Sie in der Adressleiste zu http://localhost:8081. Jetzt wird die eigentliche Installation von Wiki.js beginnen.

Geben Sie die E-Mail-ID des Administrators, das Anmeldepasswort für den Wiki.js-Administrationsbenutzer, die URL Ihrer Wiki-Website ein und klicken Sie auf INSTALLIEREN. Die E-Mail-ID wird der Benutzername sein.

Dies wird einen Moment dauern, um Wiki.js einzurichten. Sobald die Installation abgeschlossen ist, werden Sie zur Wiki.js-Anmeldeseite weitergeleitet. Geben Sie Ihre E-Mail-Adresse und das Passwort ein, das Sie im vorherigen Schritt angegeben haben.

Das ist alles. Sie können jetzt beginnen, Ihre Startseite zu gestalten oder in die Administrationsseite zu gehen, und von dort aus können Sie alle notwendigen Seiten erstellen.

So sieht der Administrationsbereich von Wiki.js aus.

Um mit Wiki.js zu beginnen, besuchen Sie die Wiki.js-Dokumentation.

Schritt 5: Container verwalten

Laufende Container überprüfen:

podman ps

Container stoppen:

 podman-compose down

Protokolle anzeigen:

podman logs <container-id>

Fazit

Sie haben Wiki.js erfolgreich unter Verwendung von Podman und Docker Compose auf Debian Linux 12 installiert. Diese Einrichtung verwendet PostgreSQL als Datenbank und läuft im rootlosen Modus, was sie sicher und effizient macht.