Installation¶

Die empfohlene Installation startet immer über setup.sh. setup.sh lädt das passende install.sh aus dem gewünschten Branch und übergibt alle weiteren Parameter unverändert an den eigentlichen Installer.

Wichtig:

Standard-Einstieg: setup.sh
kein curl | bash
du musst die Tools nicht manuell vorinstallieren, sofern du sie nicht bewusst mit --no-* auslässt

Voraussetzungen¶

unterstütztes Linux-System
Root-Rechte oder sudo
Internetzugang während der Installation

Der Installer erkennt aktuell:

Debian
Ubuntu
Linux Mint
Pop!_OS

Standardinstallation¶

wget -qO setup.sh https://raw.githubusercontent.com/Mboehmlaender/ripster/main/setup.sh
bash setup.sh

Ohne --branch fragt setup.sh interaktiv nach dem gewünschten Branch.

Die typischen Branches sind:

main: stabiles Release
dev: aktueller Entwicklungsstand

Installation mit Branch oder Optionen¶

Beispiele:

bash setup.sh --branch main
bash setup.sh --branch dev
bash setup.sh --branch dev --dir /opt/ripster --user ripster --port 3001 --host 192.168.1.10

setup.sh wertet selbst nur --branch aus. Alles andere übernimmt install.sh.

Wichtige Optionen von `install.sh`¶

Option	Default	Zweck
`--branch <branch>`	`dev`	installiert genau diesen Git-Branch
`--dir <pfad>`	`/opt/ripster`	Installationsverzeichnis
`--user <benutzer>`	`ripster`	Systembenutzer für den Dienst
`--port <port>`	`3001`	Backend-Port
`--host <hostname\|ip>`	automatisch ermittelte Host-IP	Hostname/IP für Webzugriff und CORS
`--no-makemkv`	aus	MakeMKV nicht installieren
`--no-handbrake`	aus	HandBrake nicht installieren
`--no-nginx`	aus	nginx-Setup überspringen
`--no-system-deps`	aus	Systemabhängigkeiten nicht nachinstallieren
`--accept-makemkv-eula`	aus	MakeMKV-EULA ausdrücklich nichtinteraktiv akzeptieren
`--force-license-prompts`	aus	Lizenzabfragen auch bei vorhandenen Tools erneut anzeigen
`--reinstall`	aus	bestehende Installation aktualisieren

Was der Installer einrichtet¶

Typischer Ablauf:

Betriebssystem, Root-Rechte und Host prüfen
Systemabhängigkeiten installieren
Node.js 20 sicherstellen
optional MakeMKV installieren
optional HandBrakeCLI installieren
optional nginx konfigurieren
Repository nach --dir klonen oder aktualisieren
Backend-/Frontend-Abhängigkeiten installieren
Frontend bauen
backend/.env und Laufzeitverzeichnisse vorbereiten
ripster-backend.service anlegen und starten

Dienst prüfen¶

sudo systemctl status ripster-backend

Typische Aufrufe im Betrieb:

sudo journalctl -u ripster-backend -f
sudo systemctl restart ripster-backend

Update einer bestehenden Installation¶

Standard:

sudo bash /opt/ripster/install.sh --reinstall

Wenn die Installation mit abweichenden Kernparametern eingerichtet wurde, dieselben Parameter wieder mitgeben:

sudo bash /opt/ripster/install.sh --reinstall --dir /opt/ripster --user ripster --port 3001 --host 192.168.1.10

Alternativ kannst du auch erneut über setup.sh gehen:

sudo bash /opt/ripster/setup.sh --reinstall

--reinstall aktualisiert die Installation, behält aber die persistenten Daten der bestehenden Instanz.