Konfiguration: wo die Einstellungen stehen

Alle Werte liegen unter dem Abschnitt InvoiceApi. Drei Quellen, von innen nach außen:

Quelle	Wann
appsettings.Production.json im Zielverzeichnis	der Regelfall. Der Installer erzeugt die Datei und lässt sie bei jedem Update unangetastet
Umgebungsvariablen InvoiceApi__…	für Geheimnisse und maschinenspezifische Werte
appsettings.json	nein — siehe Warnung

Bei Umgebungsvariablen steht je Konfigurationsebene ein doppelter Unterstrich: InvoiceApi__Smtp__Host, InvoiceApi__Deployment__Mode; Listen mit Index: InvoiceApi__KnownProxies__0.

Host-Overrides gehören nicht in appsettings.json

Diese Datei ist Teil der Programmdateien und wird bei jeder Aktualisierung überschrieben — Ihre Änderung wäre nach dem nächsten Update weg. Maßgeblich ist appsettings.Production.json, die vom Update ausgenommen ist, oder die Umgebung.

Zwei Geheimnisse liest die Anwendung zusätzlich direkt aus der Umgebung und gibt ihnen Vorrang vor der Konfigurationsdatei: GDPICTURE_LICENSE_KEY und OCR_RESOURCE_FOLDER.

Nach jeder Änderung den Dienst neu starten

Einzige Ausnahme sind die API-Schlüssel: Der Dienst übernimmt Änderungen an keys/api-keys.json binnen 15 Sekunden ohne Neustart.

Der Dienst bricht bei Unsinn ab

Beim Start werden die Werte geprüft. Upload-Grenze, Ergebnis-Lebensdauer, Rate-Limit-Werte, Stapelgröße, Magic-Link-Laufzeit und Sitzungsdauer müssen positiv sein.

Warum ein Nichtstart besser ist als ein Fehlbetrieb

Ein stiller Betrieb mit unbrauchbaren Grenzen — Upload-Grenze 0, Sitzungsdauer negativ — wäre schwerer zu finden als ein Dienst, der gar nicht hochkommt und den Grund ins Protokoll schreibt.

Ein vollständiges Beispiel

{
  "InvoiceApi": {
    "Deployment": { "Mode": "OnPremise" },        // nicht ändern
    "DataDirectory": "D:\\Invoiceflair\\Daten",
    "PublicBaseUrl": "https://rechnung.firma.de",
    "KnownProxies": [ "10.0.0.5" ],               // Adresse des Reverse Proxy
    "Smtp": {
      "Host": "smtp.firma.de", "Port": 587,
      "User": "…", "Password": "…",
      "From": "rechnung@firma.de", "UseStartTls": true
    },
    "GdPictureLicenseKey": "",                    // optional, nur OCR + Word-Vorlagen
    "OcrResourceFolder": "ocr-resources"          // optional
  },
  "Kestrel": {
    "Endpoints": {
      "Http":  { "Url": "http://0.0.0.0:5060" },
      "Https": { "Url": "https://0.0.0.0:5061",
                 "Certificate": { "Path": "C:\\certs\\firma.pfx", "Password": "…" } }
    }
  }
}

Die Optionen im Einzelnen

Die vollständigen Tabellen — je Option Vorgabe, Wirkung und Name der Umgebungsvariablen — stehen in der Referenz:

Bereich	Seite
Uploads, Mengen, Zugriffsbegrenzung	Optionen: Uploads und Grenzen
Nutzungsprotokoll und Aufbewahrung	Optionen: Protokoll und Aufbewahrung
PDF-Import, OCR, Lizenz	Optionen: PDF-Import und OCR
Mail, Kontaktadressen, CORS, Proxys	Optionen: Mail und Netzwerk
Fähigkeiten ein- und ausschalten	Funktionsschalter