DOcs

docs/getting-started/installation.md

@@ -1,103 +1,84 @@
 # Installation
 
----
+Die empfohlene Installation läuft über `install.sh` und richtet Ripster vollständig ein.
 
-## Repository klonen
+## 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
 
 ```bash
-git clone https://github.com/YOUR_GITHUB_USERNAME/ripster.git
-cd ripster
+wget -qO install.sh https://raw.githubusercontent.com/Mboehmlaender/ripster/main/install.sh
 ```
 
----
-
-## Dev-Start (empfohlen)
+### 2. Installation ausführen
 
 ```bash
-./start.sh
+sudo bash install.sh
 ```
 
-`start.sh`:
+Während der Installation wirst du nach dem HandBrake-Modus gefragt:
 
-1. prüft Node-Version (`>= 20.19.0`)
-2. installiert Dependencies (Root/Backend/Frontend)
-3. startet Backend + Frontend parallel
+- `1` Standard (`apt`)
+- `2` GPU/NVDEC (gebündeltes Binary)
 
-Danach:
-
-- Backend: `http://localhost:3001`
-- Frontend: `http://localhost:5173`
-
-Stoppen: mit `Ctrl+C` im laufenden Terminal.
-
----
-
-## Manuell starten
+### 3. Dienststatus prüfen
 
 ```bash
-npm install
-npm --prefix backend install
-npm --prefix frontend install
-npm run dev
+sudo systemctl status ripster-backend
 ```
 
-Oder getrennt:
+### 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:
 
 ```bash
-npm run dev:backend
-npm run dev:frontend
+sudo bash install.sh --branch dev
+sudo bash install.sh --port 8080 --host ripster.local
+sudo bash install.sh --reinstall
 ```
 
----
-
-## Optional: .env-Dateien anlegen
-
-### Backend
+## Betrieb im Alltag
 
 ```bash
-cp backend/.env.example backend/.env
+# 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
 ```
 
-Beispiel:
+## Häufige Stolperstellen
 
-```env
-PORT=3001
-DB_PATH=./data/ripster.db
-LOG_DIR=./logs
-CORS_ORIGIN=http://localhost:5173
-LOG_LEVEL=info
-```
+- `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
 
-### Frontend
+## Danach weiter
 
-```bash
-cp frontend/.env.example frontend/.env
-```
-
-Beispiel:
-
-```env
-VITE_API_BASE=/api
-# optional:
-# VITE_WS_URL=ws://localhost:3001/ws
-```
-
----
-
-## Datenbank
-
-SQLite wird automatisch beim Backend-Start initialisiert:
-
-```text
-backend/data/ripster.db
-```
-
-Schema-Quelle: `db/schema.sql`
-
----
-
-## Nächste Schritte
-
-1. Browser öffnen: `http://localhost:5173`
-2. In `Settings` Pfade/Tools/API-Keys prüfen
-3. Erste Disc einlegen und Workflow starten
+1. [Ersteinrichtung](configuration.md)
+2. [Erster Lauf](quickstart.md)