1.0.0 release snapshot

2026-06-12 11:17:44 +02:00
parent 6115090da1
commit c9ad6b2f06
274 changed files with 138472 additions and 1 deletions
@@ -0,0 +1,119 @@
+# 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
+
+```bash
+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
+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 |
+| `--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
+
+```bash
+sudo systemctl status ripster-backend
+```
+
+Typische Aufrufe im Betrieb:
+
+```bash
+sudo journalctl -u ripster-backend -f
+sudo systemctl restart ripster-backend
+```
+
+## Update einer bestehenden Installation
+
+Standard:
+
+```bash
+sudo bash /opt/ripster/install.sh --reinstall
+```
+
+Wenn die Installation mit abweichenden Kernparametern eingerichtet wurde, dieselben Parameter wieder mitgeben:
+
+```bash
+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:
+
+```bash
+sudo bash /opt/ripster/setup.sh --reinstall
+```
+
+`--reinstall` aktualisiert die Installation, behält aber die persistenten Daten der bestehenden Instanz.
+
+## Danach weiter
+
+1. [Ersteinrichtung](configuration.md)
+2. [Erster Lauf](quickstart.md)