Quelltext der Seite Tutorial: Wie installiere ich Uptime Kuma?

[[category:fertig]][[category:Webhosting]]

<div style="border:1px solid #808080; margin:5px 3px 0px 3px; padding:0 5px 2px 5px; background:#EEEEEE"> 
Die Container-Funktion steht derzeit ausschließlich den Tarifen "Professional Web af.stack", "Professional Web Bladeserver" und den Hauptusern (keinen DCP-Usern) zur Verfügung. </div>

= Uptime Kuma Installation per Container über DCP =

'''Zeitaufwand: 10 Minuten'''
== Voraussetzungen ==
# Die Container-Funktion muss im DCP für Ihren Haupt-FTP-User aktiviert sein – siehe [[Tutorial: Wie erstelle ich einen Container per SSH?]].
# Eine Domain oder Subdomain, um Uptime Kuma später über Ihre Webseite aufzurufen.

== Container über das DCP erstellen ==

Da im neuen Container-Feature bereits Templates vorhanden sind und demnach alle Optionen bereits gesetzt sind, klappt die Installation sehr schnell. 
Wenn Sie im DCP eingeloggt sind, müssen Sie hierfür einmal in den Bereich "Webspace" -> "Container" gehen und oben rechts auf "+ Neu Anlegen" klicken):

[[Datei:Containeranlegen.png]]

An dieser Stelle müssen Sie beim Punkt "Container Template" "Uptime Kuma" ('''1''') auswählen und noch für Ihre Installation einen Namen wählen ('''2'''). Damit Sie Ihre Container-Installation über das Web erreichen können, müssen Sie den Haken bei "Subdomain anlegen" setzen ('''3''') und dem Ganzen noch eine Subdomain zuweisen ('''4'''). Nach einem Klick auf "Container erstellen" ('''5''') wird der Container angelegt, das Ganze dauert ein paar Minuten und der Container ist wie gewünscht einsatzbereit.

= Uptime Kuma Installation per Container über SSH =

'''Zeitaufwand: 20 Minuten'''
== Voraussetzungen ==
# Die Container-Funktion muss im DCP für Ihren Haupt-FTP-User aktiviert sein – siehe [[Tutorial: Wie erstelle ich einen Container per SSH?]].
# Sie benötigen SSH-Zugang zum Server.
# Eine Domain oder Subdomain, um Uptime Kuma später über Ihre Webseite aufzurufen.

== Schritt 1: Per SSH mit dem Server verbinden ==

Verbinde dich zunächst per SSH mit deinem Server. Hier ein Tutorial hierzu:
https://support.artfiles.de/Tutorial:_SSH-Zugang_nutzen

== Schritt 2: Image für Uptime Kuma vorbereiten ==

Falls das Image noch nicht lokal vorliegt, können Sie es direkt aktualisieren mit:

<syntaxhighlight lang="bash">
docker pull louislam/uptime-kuma:latest
</syntaxhighlight>

== Schritt 3: Container für Uptime Kuma erstellen und starten ==

Für Container im Artfiles-System sind die '''Hostports im Bereich 40000–40100 freigegeben'''.  
Folglich könnte ein vollständiger Befehl für den Start von Uptime Kuma so aussehen:

<syntaxhighlight lang="bash">
docker run -d --name uptime-kuma -p 40001:3001 -v uptime-kuma-data:/app/data --restart=always louislam/uptime-kuma:latest
</syntaxhighlight>

=== Erklärung der Parameter ===
* <code>--name uptime-kuma</code> -> Name des Containers  
* <code>-p 40001:3001</code> -> leitet Port 40001 des Hosts auf Port 3001 im Container weiter. Falls Sie aktuell bereits mehrere Container verwenden, müssten Sie hier den Port des Hosts auf eine Zahl zwischen 40000-40100 anpassen, die noch nicht verwendet wurde. 
* <code>-v uptime-kuma-data:/app/data</code> -> Volume für persistente Daten  
* <code>--restart=always</code> -> Container startet automatisch nach Systemneustarts  
* <code>louislam/uptime-kuma:latest</code> -> offizielles Image von Uptime Kuma

== Schritt 4: Funktion prüfen ==

Mit folgendem Befehl können Sie prüfen, ob der Container läuft:

<syntaxhighlight lang="bash">
docker ps -a
</syntaxhighlight>

Danach sollten Sie dem Container eine Subdomain zuweisen, damit Ihre Uptime Kuma Installation auch online erreichbar ist, siehe Schritt 5.

== Schritt 5: Uptime Kuma über eigene Subdomain erreichbar machen ==

Falls der Container per HTTP (über Port 80) erreicht werden soll, muss der Container im DCP noch mit einer Subdomain verknüpft werden.
Hierfür muss unter Domains -> Subdomains -> IhreDomain.tld die gewünschte Subdomain angeklickt, beim Subdomaintyp "Container" ('''1''') und schließlich der richtige Container ('''2''') ausgewählt werden. Klicken Sie nun noch auf "Übernehmen", um die neuen Einstellungen für die Subdomains abzuspeichern ('''3'''). Danach sollten Sie Ihre Uptime Kuma-Installation per Webseitenaufruf erreichen können.

Hinweis: Hier müssen Sie ggf. noch ein paar Minuten warten, bis die neuen Einstellungen greifen. 

[[Datei:Subdomaincontainereinstlellen.png]]