Skip to main content

KeyHelp Installation

Um KeyHelp zu installieren, reicht der Aufruf eines einzelnen Befehls, anschließend werden Sie vom Assistenten durch die Installation geführt. Während der Installation werden alle notwendigen Dienste installiert und konfiguriert, so dass Sie sich um nichts weiter kümmern müssen. Nach Abschluss der Installation können Sie sofort mit der Administration ihres Servers beginnen.


Systemvoraussetzungen

  • Betriebssystem: Ubuntu LTS oder Debian
  • Arbeitsspeicher: Mindestens 1 GB RAM
  • Architektur: 64-Bit Betriebssystem (amd64 oder arm64)
  • Die Installation muss auf einem sauberen System (Minimal-Image), frei von installierter / vorkonfigurierter Software erfolgen. Sämtliche benötigten Dienste werden durch KeyHelp installiert und konfiguriert.
  • Die Installation muss als root-Benutzer durchgeführt werden.


Installation von KeyHelp

  1. Verbinden Sie sich über SSH als Benutzer root mit ihrem Server.
  2. Führen Sie den folgenden Befehl über die Kommandozeile aus

    wget https://install.keyhelp.de/get_keyhelp.php -O install_keyhelp.sh ;
bash install_keyhelp.sh ;
  3. Die Installation wird nun vorbereitet und der Installationsassistent gestartet.
    Im Assistenten haben Sie die Möglichkeit diverse Installationsparameter anzupassen.
  4. Bestätigen Sie den Beginn der Installation über den Menüpunkt Installation starten.
  5. Nach Abschluss der Installation wird ihr System neu gestartet.

Jetzt sind alle Arbeiten abgeschlossen und sie können mit der Administration ihres KeyHelp-Servers beginnen.

Die Zugangsdaten für ihren primären Administrator- und Datenbank-Account finden Sie in der Datei /root/keyhelp_login_data_*.

Wenn Sie die Meldung FEHLER: Dem Zertifikat von »install.keyhelp.de« wird nicht vertraut. erhalten, stehen Ihnen verschiedene Möglichkeiten der Problemlösung zur Verfügung:

- Fügen Sie dem wget Befehl den Parameter --no-check-certificate hinzu.
- Installieren Sie das Paket ca-certificates mit dem Befehl apt install ca-certificates.
- Führen Sie den Befehl apt update && apt upgrade aus.

KeyHelp bietet keinen Uninstaller an.
Wenn Sie KeyHelp und die im Zuge der Installation konfigurierten Dienste entfernen möchten, müssen Sie Ihren Server manuell zurücksetzen.


Installation von KeyHelp automatisieren

Für eine Nicht-interaktive Steuerung der Installation über Skripte, bietet die KeyHelp-Installation folgende Parameter.

Parameter Bedeutung
--non-interactive Führt die Installation ohne Rückfragen und Benutzerinteraktion durch.
--no-reboot   Unterbindet den Reboot im Anschluss an die Installation.
--notification=<EMAIL ADDRESS> Sendet nach Abschluss der Installation eine E-Mail an die angegebene E-Mail-Adresse.
--language=<LANGUAGE_CODE> Legt die Standardsprache von KeyHelp und seiner Komponenten fest.
--extended-log  Protokolliert alles, auch sensible Daten wie Passwörter etc.
--preferred-protocol=<PROTOCOL>

Legt das bevorzugte Protokoll bei der Kommunikation mit den Installationsservern fest.

[ipv4 / ipv6 / none]
--hostname-fqdn=<SERVER_DOMAIN>

Der vollständig qualifizierte Domainname (FQDN).

Beispiel: 'keyhelp.example.com'
--server-fqdn=<SERVER_DOMAIN> Alias für --hostname-fqdn [Veraltet]
--admin-username=<USERNAME>

Login-Name für das KeyHelp-Administrator-Konto.
--admin-password=<PASSWORD> 

Passwort für das KeyHelp-Administrator-Konto.

Mindestens 6 Zeichen.
--admin-email=<EMAIL_ADDRESS> E-Mail-Adresse für das KeyHelp-Administrator-Konto.


Mit folgendem Befehl wird KeyHelp ohne Benutzerinteraktion installiert. Es wird ein Administratorkonto mit dem Namen my-admin und dem Passwort my-password-123 angelegt. Im Anschluss an die Installation wird eine Email an info@example.com gesendet, um über den Abschluss der Installation zu informieren.

wget https://install.keyhelp.de/get_keyhelp.php -O install_keyhelp.sh ;
bash install_keyhelp.sh --non-interactive --admin-username="my-admin" --admin-password="my-password-123" --notification="info@example.com";


Installationsprotokoll

Alle Aktionen während der Installation werden im Installationsprotokoll unter /var/log/keyhelp/install.log protokolliert.
Sollten während der Installation Fehler auftreten, kann der Fehler-verursachende Befehl, sowie dessen Ursachen anhand dieses Protokolls ermittelt werden. Durchsuchen Sie hierzu die genannte Datei nach dem Schlüsselwort ERROR DETECTED. 

Back to top