Installation unter Linux

Installation des Arzt Dashboard Praxis Servers unter Linux als systemd-Dienst, inkl. Parameter, Konfigurationsdateien, Firewall und Problembehandlung.

Arzt Dashboard Praxis Server – Installation unter Linux

Der Praxis Server läuft als Systemdienst und bringt alles mit, was er braucht: eine eigene Java-Laufzeit und eine eigene PostgreSQL-Datenbank. Eine bereits vorhandene PostgreSQL-Installation wird nicht angefasst.

Voraussetzungen


System	Linux x86_64 mit systemd (z. B. Ubuntu, Debian)
Rechte	root bzw. `sudo`
Netzwerk	Port 28443 (TCP) aus dem Praxisnetz erreichbar

Installation

1. Herunterladen und entpacken

Der Server bleibt dort installiert, wo er entpackt wird – wir empfehlen /opt.

cd /opt
sudo curl -LO https://fsn1.your-objectstorage.com/arztdashboard/praxis/linux/ArztDashboardPraxisServer-linux-latest.tar.gz
sudo tar -xzf ArztDashboardPraxisServer-linux-latest.tar.gz

Warnung

Nicht in ein Home-Verzeichnis entpacken: Der Datenbankdienst läuft als Benutzer postgres und muss das Verzeichnis lesen können.

2. Installieren

cd /opt/ArztDashboardPraxisServer
sudo ./install-service.sh

Das Skript richtet die Datenbank ein, legt die beiden Dienste an und startet sie. Am Ende wird der Status des Dienstes angezeigt – dort sollte active (running) stehen.

3. Aufrufen

Im Browser: http://<IP-des-Servers>:28443

Die Arzt Dashboard App auf den Arbeitsplätzen findet den Server im Praxisnetz automatisch.

Optionale Parameter

Alle Parameter können beliebig kombiniert werden. Ohne Angabe gelten die Standardwerte.

Parameter	Bedeutung	Standard
`--app-port <Port>`	Port, unter dem der Server erreichbar ist	28443 (bei Belegung der nächste freie bis 28452)
`--pg-port <Port>`	Port der internen Datenbank (nur lokal erreichbar)	5433 (bei Belegung der nächste freie)
`--app-max-ram-mb <MB>`	Maximaler Arbeitsspeicher des Servers	¼ des Arbeitsspeichers
`--pg-max-ram-mb <MB>`	Arbeitsspeicher der Datenbank (mind. 256)	PostgreSQL-Standard

Beispiel – Server auf Port 28500, je 2 GB für Server und Datenbank:

sudo ./install-service.sh --app-port 28500 --app-max-ram-mb 2048 --pg-max-ram-mb 2048

Hinweis

Wird ein anderer Server-Port als 28443–28452 gewählt, finden die Arbeitsplätze den Server nicht mehr automatisch. Die Adresse muss dann in der App einmalig von Hand eingetragen werden.
--pg-port wirkt nur bei der Erstinstallation. Eine bestehende Datenbank behält ihren Port.

Einstellungen nachträglich ändern

Einfach das Skript mit den neuen Werten erneut ausführen – Daten und bisherige Einstellungen bleiben erhalten:

sudo /opt/ArztDashboardPraxisServer/install-service.sh --app-max-ram-mb 4096

Einstellungsdateien direkt bearbeiten

Alternativ lassen sich die Werte direkt in den Konfigurationsdateien im Installationsverzeichnis ändern. Updates überschreiben diese Dateien nicht.

Datei	Inhalt	Beispiel
`ad.local.properties`	Server-Port	`server.port=28500`
`ad.local.env`	Arbeitsspeicher des Servers	`JAVA_TOOL_OPTIONS=-Xmx2048m`
`postgres/pg.local.conf`	Arbeitsspeicher der Datenbank	siehe unten

Fehlt eine Datei, kann sie einfach angelegt werden. Zum Beispiel für den Server-Port:

cd /opt/ArztDashboardPraxisServer
sudo nano ad.local.properties

postgres/pg.local.conf enthält vier Werte, die sich aus dem Speicherbudget ableiten. Für 2 GB:

shared_buffers = 512MB
effective_cache_size = 1536MB
maintenance_work_mem = 128MB
work_mem = 32MB

Danach den betroffenen Dienst neu starten:

Geänderte Datei	Befehl
`ad.local.properties`, `ad.local.env`	`sudo systemctl restart ArztDashboardPraxisServer`
`postgres/pg.local.conf`	`sudo systemctl restart ArztDashboardPraxisServerPg` (startet den Server mit neu)

Hinweis

Wird install-service.sh später mit einem Parameter erneut ausgeführt, überschreibt es den zugehörigen Wert in der Datei.
postgres/pg.local.properties und postgres/pg.super.local enthalten die Zugangsdaten der Datenbank. Diese Dateien nicht verändern.

Firewall (falls aktiviert)

Das Installationsskript öffnet keine Ports. Ist eine Firewall aktiv, den Server-Port freigeben, z. B. mit ufw:

sudo ufw allow 28443/tcp

Updates

Der Server aktualisiert sich selbst. Eine Neuinstallation ist dafür nicht nötig.

Nützliche Befehle

Aufgabe	Befehl
Status anzeigen	`systemctl status ArztDashboardPraxisServer`
Neu starten	`sudo systemctl restart ArztDashboardPraxisServer`
Live-Log ansehen	`journalctl -u ArztDashboardPraxisServer -f`
Status der Datenbank	`systemctl status ArztDashboardPraxisServerPg`

Problembehandlung

Meldung / Symptom	Lösung
`Must run as root.`	Befehl mit `sudo` ausführen.
`The 'postgres' user cannot enter …`	Archiv nach `/opt` entpacken (nicht ins Home-Verzeichnis) und erneut installieren.
Server im Browser nicht erreichbar	Dienststatus prüfen, Firewall-Freigabe prüfen, tatsächlichen Port im Log nachsehen.

Zuletzt aktualisiert am 07. November 2026