Deployment

Ein Debian- oder Ubuntu-System mit root- bzw. sudo-Zugriff.

Der Dienst läuft als eigener, unprivilegierter Benutzer ohne Login-Shell.

# Systembenutzer ohne Home-Verzeichnis und ohne Login anlegen
sudo useradd --system --no-create-home --shell /usr/sbin/nologin iuk-backend

# Verzeichnisstruktur anlegen
sudo mkdir -p /opt/iuk-backend/{data,uploads,logs}
sudo chown -R iuk-backend:iuk-backend /opt/iuk-backend

Das Server-Binary entsteht lokal über make build (Ergebnis unter bin/linux/server). Zusammen mit der Lizenzdatei nach /opt/iuk-backend kopieren.

sudo cp bin/linux/server /opt/iuk-backend/server
sudo cp license_*.lic /opt/iuk-backend/
sudo chmod +x /opt/iuk-backend/server
sudo chown iuk-backend:iuk-backend /opt/iuk-backend/server /opt/iuk-backend/license_*.lic

Die systemd-Unit aus Schritt 5 nutzt ProtectSystem=strict und gibt nur data/, uploads/ und logs/ als beschreibbar frei (ReadWritePaths) — der Rest von /opt/iuk-backend ist zur Laufzeit read-only.

Beim allerersten Start würde die Anwendung automatisch eine config.json mit dem Standardwert database_file: "database.sqlite" im Wurzelverzeichnis anlegen wollen — das schlägt unter ProtectSystem=strict fehl, da das Wurzelverzeichnis nicht beschreibbar ist.

Lösung: Vor dem ersten Start eine eigene config.json ablegen, die die Datenbank in den beschreibbaren data/-Unterordner verweist:

/opt/iuk-backend/config.json
{
  "database_file": "data/database.sqlite"
}

sudo chown iuk-backend:iuk-backend /opt/iuk-backend/config.json

Die fertige Service-Unit liegt unter server/deployment/iuk-backend.service.

sudo cp server/deployment/iuk-backend.service \
    /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now iuk-backend

systemctl status iuk-backend
● iuk-backend.service - IuK Backend
     Active: active (running) ...

curl http://localhost:3000

Erleichtert den Einstieg und das Ausprobieren — legt einen Demo-Mandanten mit Beispieldaten an.

sudo systemctl stop iuk-backend
sudo -u iuk-backend /opt/iuk-backend/server -seed
sudo systemctl start iuk-backend

Windows 10 / Windows Server 2016 oder neuer, PowerShell 5.0 oder neuer, Administratorrechte sowie eine gültige Lizenzdatei (license_*.lic).

server.exe, install.ps1 und die Lizenzdatei license_*.lic in einem gemeinsamen Ordner ablegen (z. B. C:\Temp\iuk-backend-install).

install.ps1 als Administrator ausführen. Der interaktive Assistent fragt das Installationsverzeichnis (Standard C:\iuk-backend) und den Port (Standard 3000) ab und erkennt die Lizenzdatei automatisch im selben Ordner.

cd C:\Temp\iuk-backend-install
.\install.ps1

Get-Service iuk-backend

Stop-Service iuk-backend
cd C:\iuk-backend
.\server.exe -seed
Start-Service iuk-backend