Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Installation mittels Docker

Es besteht die Möglichkeit, Hubzilla komfortabel und bequem als Docker-Container zu installieren. Dafür bieten Saiwal (sk@hub.utsukta.org) und Dale Hitchenor (@dhitchenor@fe.disroot.org) eine vorkonfigurierte Umgebung für einen Hubzilla-Container an.

1. Docker-Container von Saiwal

Hauptfeatures sind:

  • Einfache Bereitstellung: Verwenden Sie Docker Compose, um eine voll funktionsfähige Hubzilla-Instanz mit nur wenigen Befehlen einzurichten.
  • Benutzerdefinierte Konfiguration: Passen Sie Ihre Hubzilla-Installation ganz einfach mit Umgebungsvariablen für SMTP, Datenbank und mehr an.
  • Kontinuierliche Updates: Das Docker-Image ist so aufgebaut, dass es einfach aktualisiert werden kann, wenn neue Änderungen am Hubzilla-Kern oder seinen Abhängigkeiten vorgenommen werden.
  • SMTP-Integration: Integrierte Unterstützung für den Versand von E-Mails mit ssmtp, wodurch die Konfiguration von E-Mail-Benachrichtigungen für Ihre Hubzilla-Instanz erleichtert wird.

Das Repository für den Container befindet sich hier: skprg/hubzilla-docker

Das Image von Grund auf neu erstellen

  • Klonen Sie das Repository:
git clone https://github.com/skprg/hubzilla-docker.git
cd hubzilla-docker
  • Konfigurieren Sie Ihre Umgebung: Aktualisieren Sie die Datei docker-compose.yml mit Ihren SMTP- und anderen Einstellungen.
  • Erstellen und führen Sie den Container aus:
docker-compose up --build -d

Vorgefertigtes Image verwenden

  • Ersetzen Sie die folgenden Zeilen in docker-compose.yml
build:
      context: .
      Dockerfile: Dockerfile

mit

image: ghcr.io/skprg/hubzilla-docker:latest
  • Starten Sie den Container:
docker compose up -d

Greifen Sie auf Ihre Hubzilla-Instanz zu: Navigieren Sie zu http://localhost (oder der entsprechenden URL), um Ihre Hubzilla-Instanz anzuzeigen.

Weitere Hinweise / Update / Tipps

Weitere Hinweise, Upgrade-Anweisungen und Tipps finden Sie im oben verlinkten Repository.

2. Docker-Container von Dale Hitchenor

Funktionen

  • Automatische Einrichtung
  • Integrierte Add-ons, vorinstalliert
  • env-Datei für einfache Konfiguration/Aktivierung von Funktionen

Setup:

Anleitung nach dem Repo von Dale Hitchenor: dhitchenor/hubzilla

1. Klonen Sie das Git-Repository auf Ihren Server (oder wo auch immer Sie Hubzilla bereitstellen möchten).
  • Beispiel: git clone https://github.com/dhitchenor/hubzilla
    • HINWEIS: Damit dies funktioniert, müssen Sie Git installieren. Andernfalls können Sie das Repository als ZIP-Datei von GitHub herunterladen
2. Bearbeiten Sie nginx.conf:
  • Ändern Sie in Zeile 19 domain.com in den gewünschten Servernamen (z. B. funnylookingfaces.com oder www.potatogram.net).
  • Ändern Sie in Zeile 43 hub:9000 so, dass es mit dem Namen (nicht dem Containernamen) Ihres Hubzilla-Containers in Ihrer Datei docker-compose.yml übereinstimmt.
3. Bearbeiten Sie die .env-Datei
  • Je nach der von Ihnen verwendeten Datenbank kommentieren Sie die entsprechenden Zeilen aus/ein. STELLEN SIE SICHER, dass der Code für die nicht verwendete Datenbank auskommentiert ist.
    • HINWEIS: Ändern Sie keine Portnummern, es sei denn, Sie müssen dies tun, einschließlich Datenbank-Ports, nginx-Ports und Hubzilla-Ports.
  • Ändern Sie den Wert DOMAIN so, dass er den zuvor geänderten Domainnamen widerspiegelt, in der Datei nginx.conf.
  • Ändern Sie die Optionen DB agnostic so, dass sie Ihre gewünschten Datenbank-Anmeldedaten widerspiegeln.
    • HINWEIS: Wenn Sie bereits über eine Datenbank verfügen, müssen Sie die Werte von DB_NAME, DB_USER und DB_PASSWORD ändern, um diese Datenbank widerzuspiegeln. Wenn keine Datenbank vorhanden ist, wird anhand dieser Angaben eine Datenbank für Sie erstellt.
    • HINWEIS: DB_HOST sollte mit dem Namen (nicht dem Containernamen) des Datenbankcontainers übereinstimmen, der für Hubzilla oder in der Datei docker-compose.yml verwendet wird.
4. Bearbeiten Sie die Datei docker-compose.yml
  • Je nach der von Ihnen verwendeten Datenbank kommentieren Sie die entsprechenden Healthcheck-Zeilen aus/ein. STELLEN SIE SICHER, dass der Code für die nicht verwendete Datenbank auskommentiert ist.
  • Ändern Sie den gesamten Code zwischen den Symbolen < >, um die entsprechenden lokalen Verzeichnisse (insgesamt 2 unter volumes)
    • HINWEIS: Behalten Sie die Symbole < > nicht bei, sondern entfernen Sie sie.
5. Stellen Sie sicher, dass die Dateien
  • befinden. Wenn Sie den Speicherort von Dateien geändert haben, die Sie beim Klonen dieses Git-Repositorys erhalten haben, stellen Sie sicher, dass die Änderungen in der Datei docker-compose.yml berücksichtigt werden.
    • TIPP: Standardmäßig sollte sich die Datei „.env” im selben Verzeichnis wie die Datei docker-compose befinden.
    • HINWEIS: Standardmäßig befindet sich die Datei „nginx.conf” im Ordner „config”, der sich im selben Verzeichnis wie die Datei „docker-compose” befindet.
6. Führen Sie Docker Compose aus.
  • z. B. docker-compose up -d (oder docker-compose up, wenn Sie die Ausgabe der Bereitstellung sehen möchten) und navigieren Sie nach Abschluss der Bereitstellung zu Ihrer Domain (in einem Webbrowser).
    • HINWEIS: Die neue Version von Docker Compose ist verfügbar (Verwendung: docker compose up -d oder docker compose up, wenn Sie wie zuvor die Ausgabe sehen möchten).
    • Die version Ebene in der Datei docker-compose.yml ist in der neuen Version von Docker Compose nicht erforderlich; aus Gründen der Abwärtskompatibilität wurde sie beibehalten.