Aperçu de l'auto-hébergement

Mildport s’exécute dans votre propre infrastructure — comme une stack Docker Compose autonome ou sur Kubernetes via le chart Helm. Les fichiers ne quittent jamais votre VPC, et les licences se vérifient hors ligne — le moteur ne téléphone jamais à la maison.

La stack

Service	Rôle
`mildport`	Le moteur d’import + l’API REST à clé de licence (écoute sur `:8090`).
`mongo`	Métadonnées, mappings, journal de livraison.
`pdf-probe`	Sidecar de décodage — extraction de tableaux PDF.
`xlsx-decode`	Sidecar de décodage — feuilles de calcul.
`ocr`	Sidecar de décodage — scans et photos.
`minio` (optionnel)	Stockage objet compatible S3 pour les gros fichiers.

Si votre parc est déjà Postgres, FerretDB est une option expérimentale vérifiée — la même chaîne de connexion, pas une base de production pour laquelle nous tenons un support.

Démarrage

cp apps/import-service/.env.example apps/import-service/.env        # keys, Mongo, sidecars
docker compose --env-file apps/import-service/.env up --build

✔ mildport listening on :8090
✔ mongo · pdf-probe · xlsx-decode · ocr

Vérifier la santé :

curl localhost:8090/health
# {"status":"ok","service":"mildport"}

Preflight

Le moteur embarque un contrôle preflight qui refuse de vous laisser mal déployer — il valide les clés, le stockage, l’accessibilité des sidecars et les droits avant la mise en production. Exécutez-le dans le cadre de votre déploiement :

pnpm import:self-host-check

Kubernetes (Helm)

La distribution inclut un chart Helm qui déploie le moteur et les sidecars de décodage dans votre propre cluster — MongoDB et S3/MinIO restent à votre charge. Chaque sidecar se désactive individuellement, un mode all-in-one replie le moteur et les trois sidecars de décodage dans un seul pod (l’appariement sémantique reste un pod séparé, désactivable), et helm test exécute le même preflight dans le cluster avant la mise en production :

helm install mildport ./deploy/helm/mildport -n mildport --create-namespace \
  -f values.prod.yaml
helm test mildport -n mildport   # exécute le preflight self-host dans le cluster

Un runbook air-gap accompagne le chart : répliquez les images dans votre propre registry, définissez les overrides d’images et hébergez vous-même le worker pdf.js — aucun accès réseau sortant requis.

Suite : Votre premier import · Dépannage · Licences.