Self-hosting: panoramica

Mildport gira come uno stack Docker Compose autonomo nella tua infrastruttura. I file non lasciano mai la tua VPC, e le licenze si verificano offline — il motore non telefona mai a casa.

Lo stack

Servizio	Ruolo
`mildport`	Il motore di importazione + l’API REST con chiave di licenza (in ascolto su `:8090`).
`mongo`	Metadati, mappature, log di consegna.
`pdf-probe`	Sidecar di decodifica — estrazione di tabelle PDF.
`xlsx-decode`	Sidecar di decodifica — fogli di calcolo.
`ocr`	Sidecar di decodifica — scansioni e foto.
`minio` (opzionale)	Storage a oggetti compatibile S3 per file di grandi dimensioni.

Avvialo

cp .env.example .env        # keys, Mongo, sidecars
docker compose up --build

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

Controlla lo stato:

curl localhost:8090/health
# {"status":"ok","service":"cap-import"}

Preflight

Il motore include un controllo preflight che si rifiuta di farti distribuire male — convalida chiavi, storage, raggiungibilità dei sidecar ed entitlement prima di andare in produzione. Eseguilo come parte del tuo deployment:

pnpm import:self-host-check
pnpm import:config-check

Avanti: Licenze.