buchhaltung/MIGRATION-ANLEITUNG.md

Buchhaltungs-App Migration zu Proxmox

1. Voraussetzungen auf Proxmox

• LXC Container erstellt (Ubuntu/Debian empfohlen)
• Docker + Docker Compose installiert
• Netzwerkzugriff (für Zugriff über 192.168.0.x)

2. Dateien kopieren

Von deinem lokalen Rechner auf Proxmox übertragen:

# Auf Proxmox LXC ausführen:
mkdir -p /opt/buchhaltungs-app
cd /opt/buchhaltungs-app

# Folgende Dateien müssen kopiert werden:
# - docker-compose.yml
# - nginx.conf
# - backend/uploads/ (falls Dokumente vorhanden)
# - backup_vor_umzug_*.sql (Datenbank-Backup)

3. Frontend neu bauen

cd /opt/buchhaltungs-app

# Falls Frontend-Source vorhanden:
cd frontend
npm install
npm run build
cd ..

4. Container starten

docker-compose up -d db

# Warte 10 Sekunden auf DB-Start
sleep 10

# Backup einspielen
docker exec -i buchhaltung-db psql -U postgres buchhaltung < backup_vor_umzug_*.sql

# Alle Container starten
docker-compose up -d

5. Port ändern (optional)

Falls Port 3000/3001 schon belegt sind, in docker-compose.yml anpassen:

ports:
  - "3000:80"     # z.B. zu "8080:80" ändern
  - "3001:3001"   # z.B. zu "8081:3001" ändern

6. Reverse Proxy (empfohlen)

Für saubere URLs ohne Port:

• Nginx Proxy Manager auf Proxmox
• Oder Traefik im LXC
• Domain: buchhaltung.lan → 192.168.0.xxx:3000

7. Automatische Backups einrichten

Cron-Job auf Proxmox:

0 2 * * * cd /opt/buchhaltungs-app && docker exec buchhaltung-db pg_dump -U postgres buchhaltung > backups/backup_$(date +\%Y\%m\%d).sql

Dateien die du brauchst

Datei	Quelle	Ziel auf Proxmox
docker-compose.yml	~/.openclaw/workspace/buchhaltungs-app/	/opt/buchhaltungs-app/
nginx.conf	~/.openclaw/workspace/buchhaltungs-app/	/opt/buchhaltungs-app/
backend/uploads/	~/.openclaw/workspace/buchhaltungs-app/backend/	/opt/buchhaltungs-app/backend/uploads/
backup_*.sql	~/.openclaw/workspace/buchhaltungs-app/	/opt/buchhaltungs-app/
frontend/dist/	~/.openclaw/workspace/buchhaltungs-app/frontend/	/opt/buchhaltungs-app/frontend/dist/

Test nach Migration

1. http://192.168.0.xxx:3000 öffnen
2. Mit admin/admin123 anmelden
3. Stunden/Einträge prüfen
4. Dokumente testen

Rollback

Falls was schiefgeht:

docker-compose down
# Lokal weiterarbeiten - Backup ist ja erstellt