Deployment

Voraussetzungen

Docker + Docker Compose
Zugang zu mind. einem Proxmox-Host (für Agent-Install)

1. Konfiguration (`server/.env`)

DB_PASSWORD=<sicheres-passwort>
JWT_SECRET=<zufällig, min. 32 Zeichen>
ADMIN_EMAIL=admin@example.com
ADMIN_PASSWORD=<sicheres-passwort>
SERVER_URL=http://DEINE-SERVER-IP:8765

2. Stack starten

cd server
docker compose up -d        # backend + postgres

Rebuild-Pflicht: nach jeder Änderung in server/ (Router, Models, Auth, Migrations, requirements.txt, Dockerfile, nginx):
cd server && docker-compose up -d --build
Kein Bind-Mount — Container nutzt eingebackene Files.

Dienste:

:8080 — WebUI (intern/VPN)
:8765 — Agent-WebSocket (öffentlich)

3. Proxmox-Host registrieren

Browser → http://SERVER:8080 → Login
Einstellungen → Host-Provisioning → Host registrieren (Superadmin)

Auf dem Host als root:

curl -fsSL http://SERVER:8765/install/<TOKEN> | bash

Agent verbindet sich automatisch, erscheint nach Sekunden als Online.

4. VM-Guest-Agent (optional)

In der VM:

curl -fsSL http://SERVER:8765/vm-install/<TOKEN> | bash

Sicherheit

WebUI (:8080) nicht öffentlich exponieren — nur VPN/Firewall.
:8765 muss vom Proxmox-Host erreichbar sein (nginx leitet nur /ws/agent
- Install-Endpunkte).
JWT-Secret min. 32 Zeichen, zufällig.
Agent-Tokens pro-Host einmalig, via UI rotierbar.

Migrationen

Laufen automatisch beim Start (init_db() → alembic upgrade head). Neue Migration: server/migrations/versions/.