Auto-hébergement

Vous pouvez exécuter l’ensemble de la stack Pia sur votre propre infrastructure à l’aide de Docker Compose.

Un fichier de licence est nécessaire

Chaque serveur Pia fonctionne avec un .lic signé, y compris l’édition Community gratuite. Sans lui, le serveur démarre en mode configuration et ne sert plus que la connexion et la page de configuration. Demandez la licence Community gratuite à kontakt@pia-ai.de, puis activez-la comme décrit dans le guide de l’édition Community.

Prérequis

• Docker et Docker Compose
• Un domaine avec DNS configuré
• 1 Go de RAM minimum

Démarrage rapide

1. Récupérez le paquet de déploiement :

Pia Server est source-available. Demandez le code source du serveur, les fichiers de déploiement utilisés ci-dessous (docker-compose.prod.yml, .env.example, Caddyfile) et l’accès aux images de conteneurs à kontakt@pia-ai.de — la même adresse que pour la licence. Décompressez ce que vous recevez, puis exécutez les étapes suivantes depuis ce répertoire.

2. Copiez et configurez le fichier d’environnement :

cp .env.example .env.prod

3. Définissez les variables d’environnement requises dans .env.prod :

JWT_SECRET_KEY=<générez-une-chaîne-aléatoire-de-64-caractères>
ENCRYPTION_MASTER_KEY=<générez-une-chaîne-aléatoire-de-64-caractères>
POSTGRES_PASSWORD=<mot-de-passe-fort>

4. Démarrez les services :

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

Architecture

La stack de production se compose de :

Service	Image	Port	Rôle
Caddy	caddy:2-alpine	80, 443	Reverse proxy + HTTPS automatique
Pia Server	ghcr.io/pia-ai-dev/pia-server	8080	Serveur API
PostgreSQL	postgres:17-alpine	5432	Base de données

Configuration de Caddy

Mettez à jour le Caddyfile avec votre domaine :

votre-domaine.com {
    reverse_proxy pia-server:8080
}

Caddy gère automatiquement le provisionnement des certificats TLS via Let’s Encrypt.

Mise à jour

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