====== Aufsetzen von Huly auf einem Ubuntu ======
^ Version  ^ Status          ^ Datum       ^ Autor:in       ^ URL  ^
| 0.1      | Erster Entwurf  | 28.01.2024  | Fabio Pagotto  |      |

===== 1. Kurzfassung =====

In diesem Dokument wird beschrieben, wie eine Self-hosted Variante von Huly, auf einer Ubuntu Server VM installiert wird.
===== 2. Tutorial =====

Zuerst sollte eine VM für Huly aufgesetzt werden.

Dabei gilt Folgendes zu beachten: \\
* Die VM muss 2 vCPUs sowie 4 GB RAM enthalten \\
* Bei Proxmox: CPU-typ muss umbedingt auf host gesetzt werden (Wenn dieser zu Alt ist, funktioniert danach MongoDB nicht) \\
* Als Betriebssystem sollte Linux Ubuntu 24.04 LTS verwendet werden (Andere Distributionen könnten funktionieren, ist aber nicht abgeklärt) \\
* Zur Verwaltung wird empfohlen, bei der Installation zusätzlich den OpenSSH Server zu installieren.

Sobald diese vorhanden ist, kann begonnen werden, Huly einzurichten.

Dabei muss zuerst Docker installiert werden mittels Snap.

Dafür sollte ausgeführt werden //sudo snap install docker//

Nachdem dies erfolgt ist, können die Huly Installationsdateien heruntergeladen werden.
Dies wird mittels git aus einem Git-Repository geholt.

Dabei wird ausgeführt: "git clone https://github.com/hcengineering/huly-selfhost.git"


Sobald dieses erfolgreich heruntergeladen ist, muss in das nun neu-entstandene Verzeichnis //huly-selfhost// gewechselt werden.
Dies mittels //cd huly-selfhost//. 

In diesem Verzeichnis sollte nun das setup.sh Skript ausgeführt werden mit //./setup.sh//.

In diesem Skript müssen folgende Parameter konfiguriert werden: \\
* IP-Adresse/Hostname auf der Huly laufen soll \\
* Port auf dem Huly laufen soll \\
* Ob SSL verwendet werden soll oder nicht 


Geben Sie bei der IP-Adresse, unbedingt dieselbe an wie die der VM. Lassen Sie den Port auf der Standard-Einstellung (Port 80).
Lehnen Sie den Vorschlag SSL zu verwenden ab.

Danach werden Sie gefragt, ob Huly gestartet werden soll. Nehmen Sie dies unbedingt an.

Nun wird Huly das erste Mal gestartet, dies kann einen Moment dauern.

Zuletzt werden Sie gefragt, ob Sie die geupdatete Huly config laden wollen. Lehnen Sie dies ab.

Damit ist nun alles eingerichtet. Rufen Sie im Browser nun die IP-Adresse der Huly-VM auf. Sollte Alles Funktioniert haben, erscheint der Huly Login-Screen.

{{:de:pasted:20250128-115101.png? 600|}}


Bitte beachten Sie, dass hierbei das Login mit einem Code nicht funktioniert.

Ansonsten können nun mittels //Sign-up// neue Konten erstellt werden. Zum einloggen, muss //Login with a Password// verwendet werden.

Huly ist nun einsatzbereit!

===== 3. Quellenverzeichnis =====

https://github.com/hcengineering/huly-selfhost