Installation¶

Die empfohlene Installation läuft über install.sh und richtet Ripster vollständig ein.

Du musst dafür keine Tools manuell vorinstallieren. Das Skript installiert die benötigten Abhängigkeiten automatisch, sofern sie nicht explizit mit --no-* übersprungen werden.

Unterstützte Systeme und Anforderungen¶

unterstützt laut Script: debian, ubuntu, linuxmint, pop
Ausführung als root (oder via sudo)
Internetzugang während der Installation

Schritt-für-Schritt¶

1. Installationsskript herunterladen¶

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

2. Installation ausführen¶

sudo bash install.sh

Während der Installation wählst du den HandBrake-Modus:

1 Standard (Paketinstallation)
2 GPU/NVDEC (gebündeltes Binary)

3. Dienststatus prüfen¶

sudo systemctl status ripster-backend

4. Weboberfläche öffnen¶

mit nginx (Standard): http://<Server-IP>
ohne nginx (--no-nginx): API auf http://<Server-IP>:3001/api

Was `install.sh` konkret einrichtet¶

prüft Betriebssystem, Root-Rechte und ermittelt Host/IP
aktualisiert Paketquellen und installiert Basispakete (curl, wget, git, mediainfo, udev ...)
installiert Node.js 20 (falls nicht passend vorhanden)
installiert optional MakeMKV (Build aus den offiziellen Quellen)
installiert optional HandBrakeCLI (Standard oder GPU/NVDEC)
installiert optional nginx
legt den Systembenutzer ripster an (ohne Login-Shell, ohne Home) und ergänzt Gruppen (cdrom, optical, disk, video, render, falls vorhanden)
klont das Repository nach /opt/ripster (oder aktualisiert bei --reinstall)
legt Verzeichnisse an:
/opt/ripster/backend/data
/opt/ripster/backend/logs
/opt/ripster/backend/data/output/raw
/opt/ripster/backend/data/output/movies
/opt/ripster/backend/data/logs
installiert npm-Abhängigkeiten (Root, Backend, Frontend) und baut das Frontend
erzeugt backend/.env (bei --reinstall bleibt bestehende .env erhalten)
setzt Rechte/Besitz und erstellt bei sudo-Installation zusätzlich ~/.MakeMKV für den aufrufenden Benutzer
erzeugt und startet ripster-backend.service
konfiguriert und startet nginx (falls nicht übersprungen)

Wichtige Optionen¶

Option	Default laut Script	Zweck
`--branch <branch>`	`dev`	Branch für die Installation
`--dir <pfad>`	`/opt/ripster`	Installationsverzeichnis
`--user <benutzer>`	`ripster`	Service-Benutzer
`--port <port>`	`3001`	Backend-Port
`--host <hostname>`	automatisch ermittelte Host-IP	Hostname/IP für Webzugriff/CORS
`--no-makemkv`	aus	MakeMKV-Installation überspringen
`--no-handbrake`	aus	HandBrake-Installation überspringen
`--no-nginx`	aus	nginx-Setup überspringen
`--reinstall`	aus	bestehende Installation aktualisieren

Beispiele:

sudo bash install.sh --branch dev
sudo bash install.sh --port 8080 --host ripster.local
sudo bash install.sh --reinstall

Betrieb im Alltag¶

# Logs live ansehen
sudo journalctl -u ripster-backend -f

# Dienst neu starten
sudo systemctl restart ripster-backend

# Update aus bestehender Installation
sudo bash /opt/ripster/install.sh --reinstall

Häufige Stolperstellen¶

Laufwerk nicht zugreifbar: Laufwerksrechte/Gruppen prüfen
CLI-Tool fehlt wegen --no-*: Tool nachinstallieren oder Befehl in Settings korrigieren
UI nicht erreichbar: nginx-Status und Firewall prüfen