Anleitung · macOS

PraxisZeit unter macOS einrichten

Quick-Start für macOS 13 Ventura und neuer — auf Apple Silicon (M1/M2/M3/M4) und Intel-Macs.

Voraussetzungen

Vor dem Start prüfen

macOS 13 Ventura oder neuer (14 Sonoma, 15 Sequoia)
Apple Silicon (arm64) oder Intel (x64)
Administrator-Account
Python und PostgreSQL sind im Paket gebündelt (theseus 16) — keine separate Installation nötig
Port 443 frei

Tarball entpacken

Laden Sie das passende macOS-Tarball aus dem Shop (/download): -macos-arm64 für Apple Silicon (M1–M4), -macos-x64 für Intel-Macs.

SHA-256 verifizieren:

shasum -a 256 praxiszeit-<version>-macos-arm64.tar.gz

Das Tarball entpackt flach (ohne Top-Level-Ordner) — daher in einen eigenen Ordner entpacken:

mkdir -p praxiszeit-<version>
# Apple Silicon (arm64):
tar -xzf praxiszeit-<version>-macos-arm64.tar.gz -C praxiszeit-<version>
# Intel (x64): tar -xzf praxiszeit-<version>-macos-x64.tar.gz -C praxiszeit-<version>
cd praxiszeit-<version>

Gatekeeper-Quarantäne entfernen

macOS markiert heruntergeladene Dateien mit dem Quarantäne-Flag. Entfernen Sie es vor dem ersten Start des Installers:

xattr -dr com.apple.quarantine praxiszeit-<version>

install.sh ausführen

Das Skript legt das Verzeichnis /usr/local/praxiszeit/ an, initialisiert die gebündelte PostgreSQL (theseus 16 — keine Homebrew-/Postgres.app- Installation nötig) und installiert das launchd-Plist.

sudo ./install.sh

Dienst starten (launchd)

PraxisZeit läuft auf macOS als System-LaunchDaemon, damit er auch ohne aktive Benutzersitzung läuft:

sudo launchctl bootstrap system /Library/LaunchDaemons/de.praxiszeit.server.plist
sudo launchctl enable system/de.praxiszeit.server
sudo launchctl kickstart -k system/de.praxiszeit.server

Status prüfen: sudo launchctl print system/de.praxiszeit.server. Logs liegen in /usr/local/praxiszeit/logs/.

Im Browser öffnen

Anschließend https://localhost oder https://<mac-hostname>.local im Browser öffnen und den ersten Admin-Account anlegen.

Vollständige macOS-Anleitung auf GitHub

Tipps zu PostgreSQL via Homebrew, Sicherung des Datenverzeichnisses und Konfiguration mit eigenem Zertifikat sind in der ausführlichen Doku beschrieben.