Skip to main content

KeyHelp Installation

Nach Ausführung des Befehls wird Sie KeyHelp durch die Installation führen. Danach können Sie Ihr neues Server-Management-Tool sofort uneingeschränkt nutzen.


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 erfolgen.


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. preinstaller .....
  4. Screenshot vom Menü mit einstellungsmöglichkeiten
  5. Installation läuft... 
  6. Im Anschluss an die Installation wird ihr System neu gestartet, anschließend können Sie sofort mit der Administration ihres KeyHelp servers beginnen.

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 folgenden Befehl aus apt update && apt upgrade.

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 Scripte, 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 darüber hinaus ein Administratorkonto mit dem Namen my-admin und dem Passwort my-password-123 angelegt.

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";


Fehlersuche & Fehlerbehebung

Sollten wärend der Installation Fehler auftreten, werden diese im Instlallationsprotokoll unter 

/var/log/keyhelp/install.log

hinterlegt. 

ERROR DETECTED

Dort sehen Sie mit SKIPPED DUE PREVIOUS ERRORS] nicht ausgeführte Befehle.
Durch beheben der fehlerursache und anschließendem ausführen der mittels SKIPPED markeierten Einträgen können Sie somit KeyHelp installation korrigieren.

Back to top