DOcs

README.md

@@ -26,12 +26,17 @@ Ripster ist eine lokale Web-Anwendung für halbautomatisches Disc-Ripping mit Ma
 
 ## Voraussetzungen
 
-- Linux-System mit optischem Laufwerk (oder gemounteter Quelle)
+- **Produktion (empfohlen mit `install.sh`)**:
-- Node.js `>= 20.19.0` (siehe [.nvmrc](.nvmrc))
+  - unterstütztes Debian/Ubuntu-System
-- Installierte CLI-Tools im `PATH`:
+  - root-Rechte + Internetzugang
-  - `makemkvcon`
+  - optisches Laufwerk (oder gemountete Quelle)
-  - `HandBrakeCLI`
+  - `install.sh` installiert Node.js und die benötigten Tools automatisch
-  - `mediainfo`
+- **Entwicklung (`./start.sh`, `npm run dev`)**:
+  - Node.js `>= 20.19.0` (siehe [.nvmrc](.nvmrc))
+  - installierte CLI-Tools im `PATH`:
+    - `makemkvcon`
+    - `HandBrakeCLI`
+    - `mediainfo`
 
 ## Schnellstart (Produktion)
 

docs/getting-started/index.md

@@ -12,7 +12,7 @@ Dieses Kapitel ist für den **Betrieb von Ripster im Alltag** geschrieben.
 
 | Kapitel | Zweck |
 |---|---|
-| [Voraussetzungen](prerequisites.md) | Prüfen, ob System und Tools bereit sind |
+| [Voraussetzungen](prerequisites.md) | Produktions- vs. Dev-Voraussetzungen klar trennen |
 | [Installation](installation.md) | Ripster aufsetzen und starten |
 | [Ersteinrichtung](configuration.md) | Pfade, Tools und Metadaten korrekt setzen |
 | [Erster Lauf](quickstart.md) | Ein kompletter Job von Disc bis Datei |

docs/getting-started/installation.md

@@ -2,6 +2,8 @@
 
 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

docs/getting-started/prerequisites.md

@@ -1,41 +1,21 @@
 # Voraussetzungen
 
-Diese Seite ist die praktische Checkliste vor der Installation.
+Die Voraussetzungen hängen davon ab, **wie** du Ripster betreibst.
 
-## 1) System
+## Produktionsbetrieb mit `install.sh` (Standard)
 
-| Punkt | Mindestwert | Empfehlung |
+Für den normalen Betrieb sind nur wenige Punkte vorab nötig.
-|---|---|---|
-| Betriebssystem | Linux oder macOS | Ubuntu 22.04+ |
-| Node.js | 20.19.0 | 20.x LTS |
-| RAM | 4 GB | 8 GB+ |
-| Freier Speicher | 50 GB | 500 GB+ |
 
-Node-Version prüfen:
+### Pflicht
 
-```bash
+- unterstütztes Linux-System (Debian/Ubuntu)
-node --version
+- `root`-Rechte
-```
+- Internetzugang während der Installation
+- optisches Laufwerk für Disc-Betrieb
 
-## 2) Externe Tools
+`install.sh` installiert die benötigten Tools selbst (u. a. Node.js, MakeMKV, HandBrakeCLI, MediaInfo), sofern sie nicht explizit per `--no-*` übersprungen werden.
 
-Ripster benötigt folgende CLI-Tools im `PATH`:
+### Laufwerk kurz prüfen
-
-- `makemkvcon`
-- `HandBrakeCLI`
-- `mediainfo`
-
-Schnell prüfen:
-
-```bash
-makemkvcon --version
-HandBrakeCLI --version
-mediainfo --Version
-```
-
-## 3) Optisches Laufwerk
-
-Für Disc-Betrieb muss ein DVD/Blu-ray-Laufwerk erreichbar sein.
 
 ```bash
 ls /dev/sr*
@@ -48,23 +28,21 @@ Wenn nötig Rechte setzen (Beispiel):
 sudo chmod a+rw /dev/sr0
 ```
 
-## 4) OMDb API-Key
+### Optional vorab
 
-Für automatische Metadaten (Titel, Poster, IMDb-ID):
+- OMDb API-Key (kann auch nach Installation in den `Settings` gesetzt werden)
+- PushOver-Zugangsdaten (optional)
 
-1. Key unter [omdbapi.com](https://www.omdbapi.com/apikey.aspx) anlegen
+## Entwicklungsmodus (nur für Dev)
-2. in den `Settings` als `omdb_api_key` eintragen
 
-## 5) Optional: PushOver
+Wenn du lokal entwickelst (`./start.sh`, `npm run dev`), gelten zusätzliche Voraussetzungen:
 
-Für Push-Nachrichten bei Erfolg/Fehler:
+- Node.js >= 20.19.0
+- `makemkvcon`, `HandBrakeCLI`, `mediainfo` im `PATH`
 
-- Account/App auf [pushover.net](https://pushover.net)
+Details: [Entwicklungsumgebung](../deployment/development.md)
-- `pushover_token` und `pushover_user` später in den `Settings` setzen
 
 ## Abschluss-Checkliste
 
-- [ ] Node.js 20.x verfügbar
+- [ ] Produktionsbetrieb: Linux + root + Internet + Laufwerk vorhanden
-- [ ] `makemkvcon`, `HandBrakeCLI`, `mediainfo` ausführbar
+- [ ] Dev-Modus (nur falls benötigt): Node.js und CLI-Tools verfügbar
-- [ ] Laufwerk erkannt
-- [ ] OMDb Key bereit