Installation

NEVARO installieren

NEVARO lässt sich mit einem Installationsskript auf einem Linux-Server einrichten.

Basis Docker ComposeStand v0.0.0354

Schritt 1: Voraussetzungen

Linux-Servermit Internetzugang
~2 GB RAMArbeitsspeicher
~3 GB Platzauf der Festplatte
x86_64fertige Images; sonst baut das Skript selbst

Docker, Docker Compose, Git und weitere Werkzeuge musst du nicht vorbereiten – fehlt etwas, installiert das Skript es nach Rückfrage. Vorausgesetzt ist OpenSSL 3 (ab Debian 12, Ubuntu 22.04, RHEL 9 dabei) – damit signiert die Instanz ihre Anmeldung beim zentralen NEVARO-Dienst.

Als welcher Benutzer? Als der, der NEVARO später betreibt – also docker compose startet. Ein SSH-Schlüssel oder ein Zugang zu GitHub ist nicht nötig: NEVARO kommt vom zentralen NEVARO-Dienst.

Schritt 2: NEVARO installieren

Das Installationsskript prüft die Voraussetzungen, lädt NEVARO herunter und startet die Anwendung.

Shell

$ curl -fsSLO https://portal.nevaro.fit/install.sh
$ bash install.sh

Das Skript fragt nach der Adresse, unter der NEVARO im Browser geöffnet wird (Vorgabe: die IP des Servers, z. B. http://192.168.1.20:3000) und trägt sie als FRONTEND_URL und CORS_ORIGINS ein – daraus entstehen Einladungs- und Passwort-Links. Beginnt sie mit http://, setzt es zugleich COOKIE_SECURE=false, sonst würde der Browser das Login-Cookie verwerfen. Steht später ein HTTPS-Proxy davor: siehe Eigene Domain mit TLS.

Belegte Ports meldet das Skript vorab und schlägt freie vor. Ein zweiter Aufruf im selben Verzeichnis ist gefahrlos: eine vorhandene .env und ein vorhandener Klon bleiben, wie sie sind, und eine begonnene Anmeldung wird fortgesetzt.

Schritt 3: NEVARO öffnen

Nach dem Start NEVARO im Browser öffnen und das erste Admin-Konto anlegen – unter der Adresse, die bei der Installation angegeben wurde (das Skript zeigt sie am Ende noch einmal):

Adresse

http://<server-ip>:3000

Weiter mit der ersten Einrichtung. Für eine eigene Adresse mit HTTPS siehe Eigene Domain mit TLS.

Schritt 4: Erweiterte Optionen

Nur für besondere Fälle, etwa eine automatisierte Installation. Die Variablen stehen vor dem Aufruf.

Variablen des Installationsskripts

NEVARO_YES=1: Ohne Rückfragen.
NEVARO_SKIP_START=1: Nur einrichten, NEVARO nicht starten.
NEVARO_APP_PORT, NEVARO_API_PORT: Ports auf dem Host (Vorgabe 3000/8000).
NEVARO_PUBLIC_URL: Adresse, unter der NEVARO geöffnet wird (Vorgabe http://<IP des Servers>:<App-Port>); mit http:// wird COOKIE_SECURE=false gesetzt.
NEVARO_DIR: Zielordner, Standard ./nevaro.
NEVARO_PORTAL: Adresse des zentralen NEVARO-Diensts, Standard https://portal.nevaro.fit.
NEVARO_REPO: Nur für den alten Weg direkt von GitHub (dann mit eigenem, freigeschaltetem SSH-Schlüssel), z. B. [email protected]:pillon25/helix.git.

Beispiel ohne Rückfragen:

Shell

$ NEVARO_YES=1 NEVARO_APP_PORT=3000 NEVARO_API_PORT=8000 bash install.sh