Self-Hosting

Du kannst den gesamten Pia-Stack auf deiner eigenen Infrastruktur mit Docker Compose betreiben.

Voraussetzungen

• Docker und Docker Compose
• Eine Domain mit konfiguriertem DNS
• Mindestens 1 GB RAM

Schnellstart

1. Klone das Repository:

git clone https://github.com/Pia-Ai-dev/Pia.git
cd Pia

2. Kopiere und konfiguriere die Umgebungsdatei:

cp .env.example .env.prod

3. Setze die erforderlichen Umgebungsvariablen in .env.prod:

JWT_SECRET_KEY=<generiere-einen-zufälligen-64-Zeichen-String>
ENCRYPTION_MASTER_KEY=<generiere-einen-zufälligen-64-Zeichen-String>
POSTGRES_PASSWORD=<starkes-Passwort>

4. Starte die Services:

docker compose -f docker-compose.prod.yml up -d

Architektur

Der Produktions-Stack besteht aus:

Service	Image	Port	Zweck
Caddy	caddy:2-alpine	80, 443	Reverse Proxy + automatisches HTTPS
Pia Server	ghcr.io/pia-ai-dev/pia-server	8080	API-Server
PostgreSQL	postgres:17-alpine	5432	Datenbank

Caddy-Konfiguration

Aktualisiere das Caddyfile mit deiner Domain:

deine-domain.de {
    reverse_proxy pia-server:8080
}

Caddy übernimmt die TLS-Zertifikatbereitstellung automatisch über Let’s Encrypt.

Aktualisierung

docker compose -f docker-compose.prod.yml pull
docker compose -f docker-compose.prod.yml up -d