Prérequis
- Docker Engine 24 ou une version ultérieure avec Compose v2
- Node.js 22 ou une version ultérieure, pour générer les secrets
- au moins 2 vCPU, 4 Go de RAM et un stockage disque durable
- un nom DNS public pour le tableau de bord
- des comptes Twilio et OpenAI pour les appels en direct, et un trunk Twilio Elastic SIP pour les appels téléphoniques
Configurer l’environnement
.env.example vers .env et remplit chaque mot de passe de rôle PostgreSQL et chaque secret interne avec une valeur aléatoire de 64 caractères. Il n’écrase pas un .env existant, sauf si vous passez --force, qui remplace aussi tous les secrets qu’il contient.
Ouvrez ensuite .env et définissez APP_BASE_URL, OPENAI_API_KEY et vos identifiants Twilio. Les services construisent leurs chaînes de connexion à la base de données à partir des mots de passe des rôles. Vous n’avez donc à écrire aucune URL de base de données.
Compose définit STORAGE_PROVIDER=local par défaut. L’admin et le worker montent le même volume persistant storage_data dans /var/lib/lobbystack/storage.
Démarrer LobbyStack
docker compose logs, et les points de terminaison de santé continuent de fonctionner.
Servir le HTTPS depuis Caddy
Par défaut, le Caddy de Compose sertAPP_HOSTNAME en HTTP simple et ne publie aucun port 443, pour un usage local ou derrière votre propre proxy HTTPS. Sur un serveur public, Caddy peut servir le HTTPS lui-même : docker-compose.tls.yml le fait passer à docker/caddy/Caddyfile.tls et publie le port 443. Définissez ces valeurs dans .env :
COMPOSE_FILE, chaque commande docker compose utilise les deux fichiers. Faites pointer le nom DNS du tableau de bord vers le serveur, ouvrez les ports 80 et 443, puis redémarrez la pile. Caddy obtient le certificat d’un nom d’hôte à la première visite. Avant cela, il interroge l’admin à /api/tls/ask, qui n’approuve que ces noms d’hôte :
- le nom d’hôte de
APP_BASE_URL, les origines deAUTH_TRUSTED_ORIGINSet les hôtes deMARKETING_HOSTS - les sous-domaines de
PARTNER_BASE_DOMAINde vos partenaires - les domaines que vos partenaires ont connectés, une fois que le worker a constaté que leur DNS pointe vers votre serveur et que leur enregistrement TXT est en place
CADDY_ON_DEMAND_TLS=true, les partenaires connectent un sous-domaine de leur propre site sur la page Image de marque et domaine de la console. Tant que vous vendez des niveaux de partenaire avec les produits POLAR_PARTNER_*, un partenaire a besoin d’un niveau payant pour cela ; sinon, tout partenaire le peut. La page indique deux enregistrements à ajouter : un CNAME qui pointe vers PARTNER_DOMAIN_CNAME_TARGET, et un enregistrement TXT qui prouve que le partenaire contrôle le domaine. Laissez CADDY_ON_DEMAND_TLS à false tant que votre Caddy sert du HTTP simple, car les domaines des partenaires n’obtiendraient aucun certificat.
Connecter les domaines des partenaires avec Cloudflare for SaaS
Si le DNS dePARTNER_BASE_DOMAIN est chez Cloudflare, les domaines de vos partenaires peuvent passer par Cloudflare for SaaS au lieu du TLS à la demande de Caddy. Cloudflare émet alors le certificat de chaque domaine, et le worker enregistre et vérifie chaque domaine avec l’API de Cloudflare. Configurez-le une fois :
- Dans la zone Cloudflare de
PARTNER_BASE_DOMAIN, ouvrez SSL/TLS > Custom Hostnames et activez Cloudflare for SaaS. - Ajoutez un enregistrement DNS proxifié qui pointe vers votre serveur, comme
host.partners.example.com, puis ajoutez-le avec Add Fallback Origin sur la page Custom Hostnames. - Créez un jeton d’API avec l’autorisation Zone > SSL and Certificates > Edit pour cette zone.
- Dans
.env, définissez le jeton dansCLOUDFLARE_SAAS_API_TOKENet l’ID de la zone dansCLOUDFLARE_SAAS_ZONE_ID, puis redémarrez la pile. - Réglez le mode de chiffrement SSL/TLS de la zone sur Full. Cloudflare se connecte à votre serveur avec le domaine de chaque partenaire, que votre certificat d’origine ne couvre pas.
Host. Les partenaires font ensuite pointer un enregistrement CNAME vers l’origine de repli, ou vers PARTNER_DOMAIN_CNAME_TARGET si vous la définissez, et ajoutent l’enregistrement TXT que leur console indique. Si Cloudflare for SaaS et CADDY_ON_DEMAND_TLS sont tous deux définis, le déploiement utilise Cloudflare for SaaS.
Choisir un backend de stockage
Le fournisseur local par défaut prend en charge un seul hôte Docker. Sauvegardez le volumestorage_data en même temps que PostgreSQL et restaurez les deux à partir du même point de restauration.
Utilisez S3 quand l’admin et le worker tournent sur des hôtes différents. Définissez ces valeurs dans .env :
Exporter les données OpenTelemetry
L’export OpenTelemetry est désactivé quandOTEL_EXPORTER_OTLP_ENDPOINT est vide. Pour envoyer des traces, des métriques et des journaux OpenTelemetry à PostHog, ajoutez ces valeurs à .env :
/v1/traces, /v1/metrics et /v1/logs à l’URL de base. Vous pouvez utiliser les mêmes variables avec un autre backend compatible OTLP.
Redémarrez les conteneurs de l’application après avoir modifié les valeurs :
Vérifier le déploiement
Liste de vérification pour la production
- remplacez tous les identifiants de développement et limitez les permissions de
.env - utilisez une valeur HTTPS de production pour
APP_BASE_URL - définissez
OPENAI_WEBHOOK_SECRETetTWILIO_SIP_TRUNK_SIDpour répondre aux appels téléphoniques. Le worker ne provisionne pas de numéro de téléphone sansTWILIO_SIP_TRUNK_SID. Les variables des appels vocaux décrivent le rôle de chacune - définissez
WEB_CALL_ALLOWED_ORIGINSavec les sites exacts qui hébergent votre appel de démo public, si vous en avez un - configurez des sauvegardes de PostgreSQL et du stockage de fichiers hors de l’hôte
- faites un exercice de restauration avant d’accepter du trafic de production
- limitez les ports de PostgreSQL, de Redis et de MinIO (facultatif) aux réseaux privés
- surveillez l’état de l’admin, du worker, de la file d’attente, de la base de données et du stockage d’objets
- épinglez les versions des images avant les mises à niveau planifiées