LeoCRM Deployment

Quick Start

Option A: Coolify (empfohlen für Produktion)

# Einmalig: Umgebungsvariablen setzen
export COOLIFY_API_TOKEN="dein-token"
export COOLIFY_APP_UUID="deine-app-uuid"

# Deploy
python scripts/deploy.py

# Redeploy (ohne Neubuild)
python scripts/deploy.py --skip-build

Das Script macht automatisch:

Coolify Build & Deploy triggern
Persistent Volume in Coolify DB konfigurieren (automatisch, portabel)
Auf healthy Container warten
RLS auf allen Tenant-Tabellen sicherstellen
DB-Migrationen verifizieren
Worker-Container starten
App-Health verifizieren
Domain-Erreichbarkeit prüfen

Funktioniert auf jeder Coolify-Instanz. Bei mehreren Apps. Bei Erst-Deploy und Redeploy.

Option B: Docker Compose (lokal / ohne Coolify)

# .env.docker erstellen
cp .env.docker.example .env.docker
$EDITOR .env.docker  # SECRET_KEY, POSTGRES_PASSWORD, etc. ausfüllen

# Starten (alle 4 Container: Postgres, Redis, App, Worker)
docker compose --env-file .env.docker up --build -d

# Health check
curl http://localhost:8000/api/v1/health

# Stoppen
docker compose down

Container:

crm-postgres — PostgreSQL 16 mit pgvector
crm-redis — Redis 7
crm-app — FastAPI API Server
crm-worker — ARQ Background Worker

Alle mit persistenten Volumes. Kein Datenverlust bei Redeploy.

Voraussetzungen

Python 3.12+
Docker & Docker Compose (für Option B)
Coolify v4+ (für Option A)
SSH-Zugang zum Server (für Option A)

Umgebungsvariablen

Siehe .env.example für alle Variablen. Wichtigste:

Variable	Pflicht	Default	Beschreibung
`DATABASE_URL`	Ja	—	PostgreSQL Connection String
`REDIS_URL`	Ja	—	Redis Connection String
`SECRET_KEY`	Ja	—	Mindestens 32 Zeichen
`ENVIRONMENT`	Nein	`development`	`production` oder `development`
`SESSION_COOKIE_SECURE`	Nein	`true`	In Production muss `true`
`STORAGE_PATH`	Nein	`/data/storage`	Datei-Upload-Pfad
`STORAGE_BACKEND`	Nein	`local`	`local` oder `s3`

S3 Storage (optional)

Die App unterstützt S3-kompatiblen Storage. Setze:

STORAGE_BACKEND=s3
S3_ENDPOINT=https://s3.example.com
S3_BUCKET=leocrm
S3_ACCESS_KEY=...
S3_SECRET_KEY=...

Test- vs. Produktionsumgebung

Test:

python scripts/deploy.py --environment test

Eigene Coolify-App, eigene DB, eigene Domain (crm-test.media-on.de).

Produktion:

python scripts/deploy.py --environment production

Troubleshooting

Container nicht healthy:

docker logs <container-name> --tail 50

Migration fehlgeschlagen:

docker exec <container> alembic upgrade head

RLS nicht aktiv:

python scripts/deploy.py --migrate-only

Worker nicht gestartet:

python scripts/deploy.py --skip-build  # startet Worker automatisch

2.9 KiB Raw Blame History