Installation

Repository klonen

git clone https://github.com/YOUR_GITHUB_USERNAME/ripster.git
cd ripster

Automatischer Start

Ripster enthält ein start.sh-Skript, das alle Abhängigkeiten installiert und Backend + Frontend gleichzeitig startet:

./start.sh

Das Skript führt automatisch folgende Schritte durch:

Node.js-Versionscheck – prüft ob >= 20.19.0 verfügbar ist (mit nvm/npx-Fallback)
Abhängigkeiten installieren – npm install für Root, Backend und Frontend
Dienste starten – Backend und Frontend werden parallel gestartet

!!! success "Erfolgreich gestartet" - Backend läuft auf http://localhost:3001 - Frontend läuft auf http://localhost:5173

Manuelle Installation

Falls du mehr Kontrolle benötigst:

# Root-Abhängigkeiten
npm install

# Backend-Abhängigkeiten
cd backend && npm install && cd ..

# Frontend-Abhängigkeiten
cd frontend && npm install && cd ..

# Backend starten (Terminal 1)
cd backend && npm run dev

# Frontend starten (Terminal 2)
cd frontend && npm run dev

Umgebungsvariablen konfigurieren

Backend

cp backend/.env.example backend/.env

Bearbeite backend/.env:

PORT=3001
DB_PATH=./data/ripster.db
CORS_ORIGIN=http://localhost:5173
LOG_DIR=./logs
LOG_LEVEL=info

Frontend

cp frontend/.env.example frontend/.env

Bearbeite frontend/.env:

VITE_API_BASE=http://localhost:3001
VITE_WS_URL=ws://localhost:3001

!!! tip "Alle Umgebungsvariablen" Eine vollständige Übersicht aller Umgebungsvariablen findest du unter Umgebungsvariablen.

Datenbank initialisieren

Die SQLite-Datenbank wird automatisch beim ersten Start erstellt und mit dem Schema aus db/schema.sql initialisiert. Es sind keine manuellen Datenbankschritte erforderlich.

backend/data/
└── ripster.db    ← Wird automatisch angelegt

Stoppen

./kill.sh

Das Skript beendet Backend- und Frontend-Prozesse graceful.

Verzeichnisstruktur nach Installation

ripster/
├── backend/
│   ├── data/           ← SQLite-Datenbank (nach erstem Start)
│   ├── logs/           ← Log-Dateien
│   ├── node_modules/   ← Backend-Abhängigkeiten
│   └── .env            ← Backend-Konfiguration
├── frontend/
│   ├── node_modules/   ← Frontend-Abhängigkeiten
│   ├── dist/           ← Production-Build (nach npm run build)
│   └── .env            ← Frontend-Konfiguration
└── node_modules/       ← Root-Abhängigkeiten (concurrently etc.)

Nächste Schritte

Nach erfolgreicher Installation:

Öffne http://localhost:5173
Navigiere zu Einstellungen
Konfiguriere Pfade, API-Keys und Encoding-Presets

:octicons-arrow-right-24: Zur Konfiguration

2.9 KiB Raw Blame History Unescape Escape