Docker Lite

RAMP Lite ist eine minimale Docker-Bereitstellung für schnelle Demos, Evaluierungen und kleine Teams. Sie verwendet SQLite und lokalen Dateispeicher, sodass keine externe Datenbank oder kein Objektspeicher konfiguriert werden muss.

Am besten geeignet für

Schnelle Demos und Evaluierungen
Kleine Teams (1—10 Benutzer)
Entwicklung und Tests
Isolierte oder Offline-Umgebungen

Einschränkungen

Nicht geeignet für mehr als 10 gleichzeitige Benutzer
Keine horizontale Skalierung (einzelne API-Instanz)
Keine Unternehmensauthentifizierung (LDAP/OIDC)
Dateien werden lokal gespeichert (nicht instanzübergreifend geteilt)

Voraussetzungen

Docker Desktop 4.0+ oder Docker Engine 20.10+
Docker Compose 2.0+
Verfügbarer Arbeitsspeicher: mindestens 2 GB
Speicherplatz: mindestens 5 GB

Schnellstart

Navigieren Sie zum RAMP-Verzeichnis:
Terminal-Fenster
```
cd /path/to/RAMP
```
RAMP Lite starten:
Terminal-Fenster
```
docker-compose -f docker-compose.lite.yml up -d --build
```
Beim ersten Start werden die Docker-Images erstellt, was 3—5 Minuten dauert.

Auf den Start warten (typischerweise 20—30 Sekunden):

docker-compose -f docker-compose.lite.yml logs -f
# Warten auf: "Application started. Press Ctrl+C to shut down."

Öffnen Sie Ihren Browser unter http://localhost.

Standardanmeldedaten

Konto	Wert
E-Mail	`admin@ramp.local`
Passwort	`Admin123!`

Dienst-URLs

Dienst	URL	Beschreibung
Webanwendung	http://localhost	Hauptoberfläche von RAMP
API (direkt)	http://localhost:5000/api	API-Endpunkte (Nginx umgehen)
Integritätsprüfung	http://localhost:5000/health	API-Integritätsstatus

Datenpersistenz

Alle Daten werden in Docker-Volumes gespeichert:

docker volume ls | grep ramp
# ramp-lite-data      (SQLite-Datenbank)
# ramp-lite-logs      (Anwendungsprotokolle)
# ramp-lite-uploads   (Dateianhänge)

Sicherung

mkdir -p ./backups

# Datenbank sichern
docker cp ramp-api:/app/data/ramp.db ./backups/ramp_$(date +%Y%m%d).db

# Uploads sichern
docker cp ramp-api:/app/uploads ./backups/uploads_$(date +%Y%m%d)

Wiederherstellung

# Container stoppen
docker-compose -f docker-compose.lite.yml stop

# Datenbank wiederherstellen
docker cp ./backups/ramp_20260110.db ramp-api:/app/data/ramp.db

# Uploads wiederherstellen
docker cp ./backups/uploads_20260110 ramp-api:/app/uploads

# Container starten
docker-compose -f docker-compose.lite.yml start

Häufige Vorgänge

Protokolle anzeigen

# Alle Protokolle
docker-compose -f docker-compose.lite.yml logs -f

# Nur API-Protokolle
docker-compose -f docker-compose.lite.yml logs -f ramp-api

# Letzte 50 Zeilen
docker-compose -f docker-compose.lite.yml logs --tail=50

Dienste neu starten

# Alle neu starten
docker-compose -f docker-compose.lite.yml restart

# Nur API neu starten
docker-compose -f docker-compose.lite.yml restart ramp-api

Dienste stoppen

docker-compose -f docker-compose.lite.yml stop

docker-compose -f docker-compose.lite.yml down

# WARNUNG: Löscht ALLE Daten einschließlich Datenbank und Uploads
docker-compose -f docker-compose.lite.yml down -v

Auf neueste Version aktualisieren

git pull
docker-compose -f docker-compose.lite.yml up -d --build

Konfiguration

Das JWT-Secret ändern

Für alles über eine schnelle Demo hinaus setzen Sie ein benutzerdefiniertes JWT-Secret:

# .env-Datei erstellen oder bearbeiten
echo 'JWT_SECRET=YourRandomSecretKeyAtLeast32CharactersLong!' > .env

# Neu starten
docker-compose -f docker-compose.lite.yml down
docker-compose -f docker-compose.lite.yml up -d

Benutzerverwaltung

Neuen Benutzer erstellen

Als Admin anmelden.
Zu Admin dann Benutzer navigieren.
Auf Benutzer erstellen klicken.
E-Mail (als Benutzername verwendet), Anzeigename und Passwort (mindestens 8 Zeichen) eingeben.
Rollen zuweisen (Administrator, Template Creator usw.).
Auf Speichern klicken.

Zu Admin dann Benutzer navigieren, den Benutzer suchen, auf Bearbeiten klicken und dann Passwort zurücksetzen.

Fehlerbehebung

http://localhost nicht erreichbar

# Container-Status prüfen
docker-compose -f docker-compose.lite.yml ps

Die erwartete Ausgabe zeigt ramp-api als Up (healthy) und ramp-web als Up.

Häufige Ursachen:

Port 80 bereits belegt — andere Dienste auf Port 80 stoppen
Port 5000 bereits belegt — andere Dienste auf Port 5000 stoppen

Datenbankverbindungsfehler

# Datenbankdatei prüfen
docker-compose -f docker-compose.lite.yml run --rm ramp-api ls -la /app/data/

# Neu starten
docker-compose -f docker-compose.lite.yml restart

Datenbank ist beschädigt

Neu erstellen (Datenverlust)
Aus Sicherung wiederherstellen

docker-compose -f docker-compose.lite.yml down
docker volume rm ramp-lite-data
docker-compose -f docker-compose.lite.yml up -d

docker-compose -f docker-compose.lite.yml stop
docker cp ./backups/ramp_20260110.db ramp-api:/app/data/ramp.db
docker-compose -f docker-compose.lite.yml start

Dateien werden nicht hochgeladen

# Berechtigungen prüfen
docker-compose -f docker-compose.lite.yml exec ramp-api ls -la /app/uploads

# Berechtigungen korrigieren
docker-compose -f docker-compose.lite.yml exec ramp-api chown -R app:app /app/uploads
docker-compose -f docker-compose.lite.yml restart ramp-api

Hohe Arbeitsspeicherauslastung

RAMP Lite verwendet normalerweise etwa 500 MB RAM. Bei höherer Auslastung:

# Arbeitsspeicherauslastung prüfen
docker stats ramp-api

# Neu starten, um Caches zu leeren
docker-compose -f docker-compose.lite.yml restart ramp-api

Ressourcenauslastung

Ressource	Typische Auslastung
RAM	500 MB — 1 GB
CPU	5—15% (im Leerlauf)
Speicher	500 MB (Basis) + Daten/Uploads
Startzeit	20—30 Sekunden

Überwachung

# API-Integritätsprüfung
curl http://localhost:5000/_health

# Datenbankgröße
docker exec ramp-api du -h /app/data/ramp.db

# Live-Protokolle
docker-compose -f docker-compose.lite.yml logs -f --tail=100

Wann sollte ein Upgrade durchgeführt werden?

Ziehen Sie ein Upgrade von Lite auf Docker Full oder Docker Cluster in Betracht, wenn:

Sie mehr als 10 gleichzeitige Benutzer haben
Sie Unternehmensauthentifizierung (LDAP/OIDC) benötigen
Sie Hochverfügbarkeit benötigen (keine Ausfallzeiten bei Updates)
Sie zentralisierten Dateispeicher benötigen
Sie horizontale Skalierung benötigen

Migration zu Full oder Cluster

Lite-Datenbank sichern:

docker cp ramp-api:/app/data/ramp.db ./ramp_lite_backup.db

Nach SQL exportieren:

sqlite3 ramp_lite_backup.db .dump > ramp_export.sql

Die Full- oder Cluster-Bereitstellung einrichten (siehe die jeweiligen Anleitungen).

Daten nach PostgreSQL importieren:

# SQLite-SQL in PostgreSQL-Format konvertieren (manuelle Bearbeitung erforderlich)
cat ramp_export.sql | docker exec -i ramp-db psql -U ramp -d ramp