Zum Inhalt

Installation

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

Du musst dafür keine Tools manuell vorinstallieren. install.sh installiert die benötigten Abhängigkeiten automatisch (außer du überspringst sie mit --no-*).

Zielbild nach der Installation

  • Ripster-Backend als systemd-Dienst
  • Frontend über nginx erreichbar
  • UI auf http://<Server-IP>

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 wirst du nach dem HandBrake-Modus gefragt:

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

3. Dienststatus prüfen

sudo systemctl status ripster-backend

4. Weboberfläche öffnen

  • Mit nginx: http://<Server-IP>
  • Ohne nginx (--no-nginx): API auf http://<Server-IP>:3001/api

Wichtige Optionen

Option Zweck
--branch <branch> anderen Branch installieren
--dir <pfad> Installationsverzeichnis ändern
--port <port> Backend-Port setzen
--host <hostname> Hostname/IP für nginx/CORS
--no-makemkv MakeMKV nicht installieren
--no-handbrake HandBrake nicht installieren
--no-nginx nginx-Konfiguration überspringen
--reinstall Update einer bestehenden Installation

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

  • Permission denied am Laufwerk: Laufwerksrechte/Gruppen prüfen
  • Tools nicht gefunden: makemkvcon, HandBrakeCLI, mediainfo im PATH prüfen
  • UI nicht erreichbar: nginx-Status und Port/Firewall prüfen

Danach weiter

  1. Ersteinrichtung
  2. Erster Lauf