Direkt zum Hauptinhalt

Installation & Konfiguration

Voraussetzungen

  • Windows Server 2016+ oder Linux (Docker)
  • SQL Server mit WinLine-Systemdatenbank
  • Netzwerkzugriff auf den MesoSpool-Dienst (für SPL→PDF-Konvertierung)
  • Optional: WinLine-Server-Dienst (für Workflow/BelegPro)

Variante 1: Docker (empfohlen)

docker run -p 8080:8080 \
  -e Jwt__Secret="<min-32-zeichen-geheimer-schluessel>" \
  -e WinLineSystem__Server="<sql-server>" \
  -e WinLineSystem__Database="<systemdatenbank>" \
  -e WinLineSystem__Username="<benutzer>" \
  -e WinLineSystem__Password="<passwort>" \
  -e AppDatabase__ConnectionString="Server=<sql-server>;Database=MesoArchivWeb;Integrated Security=True;TrustServerCertificate=True" \
  -e MesoSpool__ServiceUrl="http://<mesospool-host>:40024" \
  csscontainers.azurecr.io/mesoarchivweb:latest

Die Anwendung ist dann unter http://localhost:8080 erreichbar.

Variante 2: Windows (Self-Contained)

  1. Laden Sie das aktuelle Release als ZIP herunter.
  2. Entpacken Sie das Archiv in ein Verzeichnis Ihrer Wahl.
  3. Passen Sie die appsettings.json an (siehe Konfiguration unten).
  4. Starten Sie MesoArchivWeb.exe.

Die Anwendung ist dann unter http://localhost:5000 erreichbar. Für HTTPS-Betrieb empfehlen wir den Einsatz eines Reverse Proxies (z. B. IIS, nginx).

Konfiguration

Die Konfiguration erfolgt über die Datei appsettings.json oder per Umgebungsvariable (doppelter Unterstrich __ als Trennzeichen).

Pflicht-Einstellungen

Abschnitt Einstellung Beschreibung
Jwt Secret Geheimer Schlüssel für die Sitzungsverwaltung (mind. 32 Zeichen). Muss auf allen Instanzen identisch sein.
Jwt Issuer / Audience Standard: MesoArchivWeb – nur ändern bei Mehrfachinstanzen.
WinLineSystem Server, Database, Username, Password Verbindung zur WinLine-Systemdatenbank (Benutzerstamm, Mandantenliste).
AppDatabase ConnectionString SQL-Server-Datenbank für anwendungseigene Daten (Einstellungen, MFA, Rollen, Share-Links). Wird beim ersten Start automatisch erstellt.
MesoSpool ServiceUrl URL des MesoSpool-Dienstes für die Dokumentkonvertierung (SPL→PDF). Format: http://<host>:<port>

Optionale Einstellungen

Abschnitt Einstellung Beschreibung
License CustomerNr, LicenseNr Lizenzschlüssel für den Vollbetrieb. Ohne Lizenz läuft die Anwendung im Demomodus (max. 10 Dokumente, kein Upload, keine Schlagwort-Bearbeitung).
WinLineServer Url URL des WinLine-Server-Dienstes. Erforderlich für Workflow- und BelegPro-Funktionen. Ohne diese Einstellung ist der Tab Meine Aufgaben nicht verfügbar.
Workflow ImportVorlagenId ID der WinLine-Importvorlage für die BelegPro-Verbuchung. Nur relevant bei aktivem Workflow mit BelegPro-Kontierung.
Ocr TessdataPath, Sprache Server-seitige OCR-Konfiguration. Standard-Sprache: deu+eng.
SessionSettings MinimumSessions, DefaultUser, DefaultPassword, DefaultCompany Voreinstellungen für WinLine-Server-Sitzungen. Normalerweise nicht erforderlich.

Beispiel appsettings.json

{
  "Jwt": {
    "Secret": "<min-32-zeichen-geheimer-schluessel>",
    "Issuer": "MesoArchivWeb",
    "Audience": "MesoArchivWeb"
  },
  "WinLineSystem": {
    "Server": "sql01.firma.local",
    "Database": "CWLSYSTEM",
    "Username": "meso",
    "Password": "<passwort>"
  },
  "AppDatabase": {
    "ConnectionString": "Server=sql01.firma.local;Database=MesoArchivWeb;Integrated Security=True;TrustServerCertificate=True"
  },
  "MesoSpool": {
    "ServiceUrl": "http://spool01.firma.local:40024"
  },
  "License": {
    "CustomerNr": "<kundennummer>",
    "LicenseNr": "<lizenznummer>"
  },
  "WinLineServer": {
    "Url": "http://wlserver01.firma.local:8080"
  },
  "Workflow": {
    "ImportVorlagenId": 1
  }
}
nach oben