# SaaS, auto-hébergé, isolé du réseau

Une seule base de code et une seule image pour chaque déploiement ; `DEPLOYMENT_MODE` choisit. Les organisations réglementées commencent généralement en auto-hébergé ou isolé du réseau.

- `saas` — Azoth l’exploite : la facturation, l’analytique produit et le site public sont activés.
- `self_hosted` — Votre cluster Kubernetes, votre base de données, votre fournisseur d’identité et votre relais e-mail. L’offre vient de votre licence (`LICENSE_PLAN`).
- `airgapped` — Comme en auto-hébergé, et le serveur n’atteint aucun hôte hors de `EGRESS_ALLOWLIST` : un appel de modèle vers tout autre hôte est refusé et scellé. Un mode inconnu est lu comme isolé du réseau.

## Installer avec Helm

Le chart (`helm/azoth-os`) fournit l’application, ses tâches planifiées, des politiques réseau, une sauvegarde nocturne de la base intégrée, et en option un Supabase intégré (Postgres, GoTrue, PostgREST) et Redis. Les secrets viennent d’un seul Secret que vous générez hors ligne :

```
kubectl create namespace azoth
node scripts/self-hosted/gen-secrets.mjs --name azoth-secrets --namespace azoth | kubectl apply -f -

helm install azoth helm/azoth-os -n azoth \
  --set appUrl=https://azoth.bank.internal \
  --set image.repository=<registry>/azoth-os --set image.digest=sha256:… \
  --set ingress.tls[0].secretName=azoth-tls
```

## Les migrations, à la main

Le chart n’applique jamais les migrations. L’image embarque l’outil qui les exécute : lancez `node migrator/scripts/migrate.mjs --status`, puis `--apply`, sous forme de Job. Il tient un registre de sommes de contrôle et refuse un fichier modifié ; l’application ne se déclare prête qu’une fois la base à la migration qu’elle attend.

## Identité et e-mail

Connexion par le fournisseur OIDC de votre organisation, ou par SAML avec Entra ID ou ADFS, déconnexion unique comprise. Les e-mails passent par votre relais SMTP : STARTTLS sans rétrogradation, jamais d’identifiants en clair.

## Isolé du réseau

- L’infrastructure propre du déploiement — sa base de données, Redis, son autorité d’horodatage et son collecteur de télémétrie — reste joignable ; tout le reste doit figurer dans la liste autorisée.
- Les modèles hébergés dans le déploiement — vLLM, TGI, LiteLLM, l’API OpenAI d’Ollama — forment le fournisseur `internal` : la même passerelle, les mêmes règles et le même journal, au prix que vous déclarez.
- Sans Internet, donnez au déploiement sa propre autorité d’horodatage : le niveau local.

```
egress:
  allowlist:
    - llm.bank.internal            # any port
    - siem.bank.internal:8443      # this port only
    - "*.models.bank.internal"     # any sub-domain
internalModels:
  - name: vllm
    baseUrl: http://vllm.models.svc:8000/v1
    models: [llama-3.1-70b-instruct]
    price: { input: 0.4, output: 0.8 }   # USD per 1M tokens, declared by you
```

## L’image signée et le bundle hors ligne

Chaque version publie une image signée et son SBOM signé, et joint un bundle hors ligne — le chart, toutes les images, un `SHA256SUMS` signé — qui se vérifie avec openssl seul, sans Internet.

## Le catalogue de modèles

Un déploiement auto-hébergé importe chaque jour le dernier catalogue de modèles signé ; un déploiement isolé du réseau importe un fichier signé depuis l’administration de la plateforme. Un catalogue est refusé s’il n’est pas signé ou si son empreinte ne correspond pas à son sha256.

Le guide complet est `docs/self-hosting.md` dans le dépôt.
