ripster/docs/getting-started/installation.md

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
--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
--reinstall	aus	bestehende Installation aktualisieren

Was der Installer einrichtet

Typischer Ablauf:

1. Betriebssystem, Root-Rechte und Host prüfen
2. Systemabhängigkeiten installieren
3. Node.js 20 sicherstellen
4. optional MakeMKV installieren
5. optional HandBrakeCLI installieren
6. optional nginx konfigurieren
7. Repository nach --dir klonen oder aktualisieren
8. Backend-/Frontend-Abhängigkeiten installieren
9. Frontend bauen
10. backend/.env und Laufzeitverzeichnisse vorbereiten
11. 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.

Danach weiter

1. Ersteinrichtung
2. Erster Lauf