Trousse d’auto-hébergement Wannlabs Entreprise : guide d’installation

1. Aperçu

Wannlabs Enterprise est une plateforme souveraine, hébergée chez vous, pour créer et publier des applications avec l’IA. Elle regroupe le créateur d’applications Ember/Prime, un portail Git d’entreprise (Gitea), l’authentification et la base de données souveraines (Supabase) et une passerelle Caddy automatisée, sans aucune télémétrie externe.

Accès anticipé. Cette trousse installe toute l’infrastructure (passerelle, portail Git, authentification et base de données Supabase, branchement du fournisseur d’IA). Les images d’Ember Studio et de l’API du créateur sont privées et sont fournies à votre compte de registre lors de l’intégration. Conditions de licence : LICENSE-EVALUATION.md. Composants libres : THIRD_PARTY_NOTICES.md.

2. Exigences d’infrastructure

• Système d’exploitation : Ubuntu Server 22.04 LTS ou 24.04 LTS (x86_64).
• Calcul : 4 à 8 vCPU au minimum (8 à 16 vCPU recommandés).
• Mémoire : 16 Go de RAM au minimum (32 Go recommandés pour beaucoup d’utilisateurs simultanés).
• Stockage : SSD NVMe de 100 Go ou plus.
• Environnements : Docker Engine 24.0+ et Docker Compose v2.
• GPU (facultatif) : GPU NVIDIA avec 16 Go de VRAM ou plus (RTX 4090, A10G, L4, A100) pour faire tourner l’IA localement.

3. Démarrage rapide (3 étapes)

Étape 1 : extraire la trousse

# .zip ou .tar.gz, selon ce que vous avez téléchargé
unzip wannlabs-enterprise-v1.1.1.zip   # ou : tar -xzf wannlabs-enterprise-v1.1.1.tar.gz
cd wannlabs-enterprise-v1.1.1
sha256sum -c ../wannlabs-enterprise-v1.1.1.sha256 2>/dev/null || true   # vérification d’intégrité facultative

Étape 2 : lancer l’assistant de configuration

./setup.sh

L’assistant va : 1. Vérifier les prérequis du système (Docker, CPU, RAM). 2. Demander votre domaine d’entreprise (p. ex. dev.acme.corp) et le courriel de l’administrateur. 3. Configurer votre fournisseur d’inférence IA (voir la section 4). 4. Générer des clés de chiffrement de 256 bits pour la base de données et les secrets JWT. 5. Créer le fichier de configuration .env de production avec des permissions restreintes (600).

Étape 3 : renforcer la sécurité de l’hôte (recommandé)

sudo ./security/setup-security.sh

Ce script applique une base de sécurité CIS : - Pare-feu UFW : limite l’accès entrant aux ports 22 (SSH avec limitation de débit), 80 (HTTP ACME/redirection) et 443 (HTTPS). - Sysctl du noyau : protection contre les inondations SYN et désactivation du routage par la source. - Fail2ban : bannit automatiquement les tentatives d’intrusion par force brute. - Mises à jour de sécurité : correctifs de sécurité quotidiens automatiques.

4. Configuration de l’inférence IA

Wannlabs prend en charge quatre configurations d’inférence IA indépendantes, selon vos exigences de conformité :

Configuration A : clé d’entreprise (BYOK / passerelle)

Branchez l’entente LLM que votre entreprise a déjà (Azure OpenAI, AWS Bedrock, Anthropic ou une passerelle vLLM interne compatible OpenAI) :

AI_PROVIDER=corporate-byok
AI_API_ENDPOINT=https://your-resource.openai.azure.com/openai/deployments/qwen-coder/chat/completions?api-version=2024-02-15-preview
AI_API_KEY=your_corporate_key_here
AI_MODEL_NAME=Qwen/Qwen2.5-Coder-7B-Instruct

Configuration B : déploiement Modal d’entreprise

Si votre organisation utilise Modal.com pour des GPU sans serveur, déployez le script modal-coder fourni dans votre propre espace Modal :

AI_PROVIDER=modal-enterprise
MODAL_CODER_URL=https://your-org--ember-coder-web.modal.run
MODAL_CODER_API_KEY=your_modal_secret
MODAL_VISION_URL=https://your-org--ember-vision-web.modal.run

Configuration C : GPU local entièrement isolé

Pour les environnements sans accès Internet (défense, banques, santé), déployez sur un serveur doté d’un GPU NVIDIA. La pile démarre directement un conteneur Ollama interne :

AI_PROVIDER=local-gpu
docker compose -f docker-compose.enterprise.yml --profile local-gpu up -d

Configuration D : licence gérée par Wannlabs

Si vous ne voulez pas gérer d’infrastructure GPU, connectez-vous avec une clé de licence Wannlabs Enterprise :

AI_PROVIDER=managed-license
WANNLABS_LICENSE_KEY=wl_ent_live_your_key_here

5. Garanties de sécurité et de souveraineté des données

1. Aucune télémétrie : les requêtes, le code et les fichiers restent à l’intérieur de vos serveurs.
2. Aucune facturation intégrée : le moteur de facturation est désactivé (BILLING_ENABLED=false), ce qui donne des sièges et des projets illimités selon votre licence d’entreprise.
3. TLS et proxy inverse automatiques : Caddy obtient et renouvelle automatiquement les certificats TLS, ou utilise vos certificats génériques d’entreprise.
4. Dépôts Git isolés : tous les projets sont versionnés dans l’instance Gitea interne de Wannlabs (git.yourdomain.corp).

6. Sauvegarde et reprise après sinistre

Toutes les données persistantes sont stockées dans des volumes Docker : - db_data : base de données de la plateforme et comptes utilisateurs. - repo_data / repo_db_data : dépôts Git et commits. - builder_data : fichiers des projets et caches de modèles locaux. - sites_data : applications web publiées en production.

Pour créer une sauvegarde immédiate :

docker compose -f docker-compose.enterprise.yml down
tar -czf wannlabs-backup-$(date +%F).tar.gz /var/lib/docker/volumes/wannlabs_*
docker compose -f docker-compose.enterprise.yml up -d