Installation unter Windows

Der Installer ist ein Inno-Setup-6-Paket (Invoiceflair-Setup-<version>.exe). Er fragt vier Dinge und richtet den Rest selbst ein.

Was der Assistent fragt

Seite	Inhalt
Zielverzeichnis	Vorgabe C:\Program Files\Invoiceflair\Portal
Datenverzeichnis	Vorgabe <Zielverzeichnis>\data. Darf außerhalb des Programmverzeichnisses liegen; wird mit Schreibrecht für das Dienstkonto angelegt
Netzwerk und Verschlüsselung	HTTP-Port (Vorgabe 5060), optional HTTPS mit eigenem Zertifikat (PFX/PKCS#12 + Kennwort, Vorgabeport 5061), öffentliche Adresse
E-Mail-Versand	SMTP-Server, Port (Vorgabe 587), Benutzername, Kennwort, Absenderadresse — überspringbar

Das Datenverzeichnis sollte außerhalb des Programmverzeichnisses liegen

Dann fällt es bei einer Deinstallation nicht mit dem Programm — und die Sicherung muss nur einen Pfad kennen. Siehe Daten und Sicherung.

Was der Installer selbst anlegt

• den Dienst Invoiceflair — Autostart, Neustart nach Absturz im Abstand von 60 s
• die Firewallregeln Invoiceflair (HTTP) bzw. (HTTPS)
• appsettings.Production.json im Zielverzeichnis
• das Datenverzeichnis

Die Verknüpfung im Startmenü zeigt auf die URL, nicht auf die .exe

Ein Doppelklick auf die Programmdatei würde eine zweite, konkurrierende Instanz starten.

Das Health-Gate nach dem Start

Zum Schluss fragt der Installer http://127.0.0.1:<port>/health in bis zu 20 Versuchen ab und meldet Erfolg erst, wenn die Antwort Healthy enthält.

Warum diese Prüfung eingebaut ist

Ohne sie meldete das Setup Erfolg, während der Dienst beim Start abgestürzt ist — belegter Port, unlesbares Zertifikat. Das ist der häufigste Fall einer „erfolgreichen“ Installation, die nicht läuft.

Antwortet der Dienst nicht, verweist der Installer auf <Zielverzeichnis>\logs.

Danach

1. Erstlauf — das erste Administratorkonto anlegen
2. Konfiguration — falls etwas anzupassen ist
3. Für unbeaufsichtigte Installation und Aktualisierung: Still installieren, aktualisieren, deinstallieren