Docker als Alternative

Für Linux-Umgebungen gibt es ein Dockerfile samt docker-compose.yml: Port 8086 → 8080 im Container, Lauf als non-root, eingebauter Healthcheck auf /health.

Das ist der Weg, wenn kein Windows-Server zur Verfügung steht — ein eigenständiges Linux-Installationspaket gibt es derzeit nicht.

Vier Volumes sind Pflicht

Ohne sie liegen die Bestandsdaten im Container, und ein up --build verwirft sie:

Volume	Inhalt
/app/data	Datenbank, Rechnungsdateien, Vorlagen je Mandant
/app/keys	API-Schlüssel (Hashes)
/app/usage	Nutzungsprotokoll
/app/.aspnet	DataProtection-Schlüsselring

Besonders /app/.aspnet wird gern vergessen

Ohne diesen Schlüsselring werden nach jedem Neustart alle Formular-Token ungültig — und damit auch alle Anmelde-Sitzungen. Der Fehler sieht aus wie ein sporadisches Anmeldeproblem.

Dazu /app/logs nach Geschmack.

Die Einstellungen kommen als Umgebungsvariablen

Im Schema InvoiceApi__…. Für den Enterprise-Betrieb gehört dazu:

environment:
  - InvoiceApi__Deployment__Mode=OnPremise
  - InvoiceApi__PublicBaseUrl=https://rechnung.firma.de

Der Build-Kontext

Der Kontext muss den gemeinsamen Elternordner beider Repositorys umfassen

Die Projektverweise auf die PDF-Bibliotheken zeigen in ein zweites Repository, und was nicht im Kontext liegt, sieht Docker nicht. Der Kopf des Dockerfile nennt den richtigen Aufruf.

Das entfällt, sobald diese Bibliotheken als Pakete vorliegen.

Was auch im Container gilt

• libicu muss im Image sein — ohne ICU startet der Prozess nicht, siehe Systemanforderungen
• die Hinweise zu Daten und Sicherung gelten entsprechend für die Volumes
• hinter einem vorgeschalteten Proxy zusätzlich Betrieb hinter einem Reverse Proxy