Skrift-Kofnigurator/Docker Backend/QUICKSTART.md

Quick Start - Deployment in 5 Minuten

Schnellste Methode: Per SCP auf Server kopieren

1. Server-Voraussetzungen prüfen

SSH auf deinen Server und prüfe:

# Docker installiert?
docker --version

# Docker Compose installiert?
docker-compose --version

# Falls nicht installiert:
curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh

2. Backend auf Server kopieren

Auf deinem lokalen Windows-Rechner (Git Bash oder WSL):

# Ins Backend-Verzeichnis
cd "/e/Dokumente/05_Skrift/Frontend_Backend_Konfigurator/Docker Backend"

# Zum Server kopieren (ersetze USER und SERVER)
rsync -avz \
  --exclude 'node_modules' \
  --exclude 'output' \
  --exclude 'cache' \
  --exclude '.git' \
  ./ root@dein-server.de:/opt/skrift-backend/

Oder mit SCP (wenn rsync nicht verfügbar):

# Windows PowerShell
scp -r "E:\Dokumente\05_Skrift\Frontend_Backend_Konfigurator\Docker Backend\*" root@dein-server.de:/opt/skrift-backend/

3. Auf dem Server starten

SSH auf den Server:

ssh root@dein-server.de

# Ins Backend-Verzeichnis
cd /opt/skrift-backend

# .env Datei erstellen
cat > .env << 'EOF'
SCRIPTALIZER_LICENSE_KEY=f9918b40-d11c-11f0-b558-0800200c9a66
SCRIPTALIZER_ERR_FREQUENCY=0
BATCH_SIZE=30
CACHE_LIFETIME_HOURS=2
RATE_LIMIT_PER_MINUTE=2
NODE_ENV=production
EOF

# Output-Verzeichnis für N8N erstellen
mkdir -p /var/skrift-output
chmod 755 /var/skrift-output

# Container bauen und starten
docker-compose up -d --build

# Logs ansehen
docker-compose logs -f

4. Testen

# Auf dem Server
curl http://localhost:4000/health

# Sollte antworten mit:
# {"status":"ok","timestamp":"..."}

5. Nginx Proxy Manager einrichten

1. Nginx Proxy Manager öffnen (z.B. http://dein-server.de:81)

2. "Proxy Hosts" → "Add Proxy Host"

3. Konfiguration:

   • Domain Names: backend.deine-domain.de
   • Scheme: http
   • Forward Hostname/IP: skrift-backend
   • Forward Port: 4000
   • Cache Assets: ✓
   • Block Common Exploits: ✓

4. Tab "SSL":

   • SSL Certificate: "Request a new SSL Certificate"
   • Force SSL: ✓
   • Email: deine@email.de

5. Speichern

6. Finaler Test

# Von deinem lokalen Rechner
curl https://backend.deine-domain.de/health

FERTIG!

Dein Backend läuft jetzt auf: https://backend.deine-domain.de

WordPress Integration

In deinem WordPress Plugin die Backend-URL eintragen:

define('SKRIFT_BACKEND_URL', 'https://backend.deine-domain.de');

Wichtige Befehle

# Container Status
docker-compose ps

# Logs ansehen
docker-compose logs -f

# Container neu starten
docker-compose restart

# Container stoppen
docker-compose down

# Update nach Code-Änderungen
docker-compose up -d --build

Problemlösung

Container startet nicht

docker-compose logs
# Häufig: Fonts fehlen oder .env nicht korrekt

Port 4000 schon belegt

# In docker-compose.yml ändern:
ports:
  - "4001:4000"  # Anderen externen Port verwenden

Keine Verbindung von außen

# Firewall prüfen
sudo ufw status
sudo ufw allow 4000/tcp

Nächste Schritte

• Siehe DEPLOYMENT.md für Details
• Siehe README.md für API-Dokumentation
• N8N Workflow einrichten für automatische Plotter-Übertragung