Files
Skrift-Kofnigurator/Docker Backend/QUICKSTART.md
2026-02-07 13:04:04 +01:00

170 lines
3.3 KiB
Markdown

# 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:
```bash
# 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):
```bash
# 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):**
```bash
# 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:
```bash
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
```bash
# 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
```bash
# 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:
```php
define('SKRIFT_BACKEND_URL', 'https://backend.deine-domain.de');
```
## Wichtige Befehle
```bash
# 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
```bash
docker-compose logs
# Häufig: Fonts fehlen oder .env nicht korrekt
```
### Port 4000 schon belegt
```bash
# In docker-compose.yml ändern:
ports:
- "4001:4000" # Anderen externen Port verwenden
```
### Keine Verbindung von außen
```bash
# Firewall prüfen
sudo ufw status
sudo ufw allow 4000/tcp
```
## Nächste Schritte
- Siehe [DEPLOYMENT.md](./DEPLOYMENT.md) für Details
- Siehe [README.md](./README.md) für API-Dokumentation
- N8N Workflow einrichten für automatische Plotter-Übertragung