Self-Hosting-Überblick

Mildport läuft als eigenständiger Docker-Compose-Stack in Ihrer eigenen Infrastruktur. Dateien verlassen nie Ihre VPC, und Lizenzen verifizieren offline — die Engine telefoniert nie nach Hause.

Der Stack

Dienst	Rolle
`mildport`	Die Import-Engine + lizenzgeschützte REST-API (lauscht auf `:8090`).
`mongo`	Metadaten, Zuordnungen, Zustellungsprotokoll.
`pdf-probe`	Decode-Sidecar — PDF-Tabellenextraktion.
`xlsx-decode`	Decode-Sidecar — Tabellen.
`ocr`	Decode-Sidecar — Scans und Fotos.
`minio` (optional)	S3-kompatibler Blob-Speicher für große Dateien.

Hochfahren

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

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

Health prüfen:

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

Preflight

Die Engine bringt eine Preflight-Prüfung mit, die ein Fehl-Deployment verweigert — sie validiert Schlüssel, Speicher, Erreichbarkeit der Sidecars und Entitlements, bevor Sie live gehen. Führen Sie sie als Teil Ihres Deployments aus:

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

Weiter: Lizenzierung.