macOS Installationsanleitung für digna Release 2026.11¶

Release: 2026.11

Zuletzt aktualisiert: 7. November 2026

Inhaltsverzeichnis¶

1. Einführung
2. Systemanforderungen
3. Vorbereitungen vor der Installation
4. PostgreSQL-Server einrichten
5. Webserver-Konfiguration
6. Erstinstallation
7. Backend-Konfiguration
8. Dashboard-Konfiguration
9. digna als Hintergrunddienst ausführen
10. Upgrade auf eine neue Version

Einführung¶

Über digna¶

digna ist eine umfassende, KI-gestützte Plattform zur Optimierung des Datenqualitätsmanagements in unterschiedlichen Datenumgebungen wie Warehouses, Lakes und Lakehouses. Entwickelt für hohe Skalierbarkeit und Anpassungsfähigkeit, adressiert digna moderne Datenherausforderungen durch Automatisierung, Echtzeit-Überwachung und Anomalieerkennung.

digna besteht aus zwei Hauptkomponenten:

• digna: Der Kern der Anwendung, zuständig für die Verarbeitung von Daten und die Durchführung von Qualitätsprüfungen. Er vereint Backend und Kommandozeilenschnittstelle in einer einzigen ausführbaren Datei und ersetzt damit die früher getrennten Programme dignabackend und dignacli.
• dignadashboard: Eine webbasierte Oberfläche, die auf einem Webserver gehostet wird und eine benutzerfreundliche Interaktion mit der digna-Plattform sowie Visualisierung der Datenqualitätskennzahlen bietet.

Neuigkeiten in Release 2026.11¶

Dieses Release ergänzt digna Data Reconciliation, digna Agentic mit dem digna MCP Server und die digna Engine, die Daten innerhalb von digna profilieren und die referenzielle Integrität zwischen unterschiedlichen Datenbanktechnologien prüfen kann. Details finden Sie in den Release Notes.

Für die Installation bringt das Release einen neuen Mechanismus für Repository-Migrationen, einen optionalen Abschnitt [duckdb] in der config.toml für die digna Engine und eine neue Lizenzdatei. Der Abschnitt zum Upgrade behandelt jeden dieser Punkte.

Suchen Sie Anleitungen für Windows oder Linux?¶

Dieses Handbuch behandelt macOS. Für andere Plattformen siehe die Windows-Installationsanleitung oder die Linux-Installationsanleitung.

Systemanforderungen¶

Bevor Sie mit der Installation beginnen, stellen Sie sicher, dass Ihr System die folgenden Mindestanforderungen erfüllt:

| Command Line Tools | Xcode Command Line Tools (erforderlich für Homebrew) |

Optionen zur Datenbankinstallation¶

Falls PostgreSQL bereits installiert ist: Sie können Ihrer bestehenden PostgreSQL-Instanz eine neue Datenbank für digna hinzufügen.

Falls Sie PostgreSQL auf derselben Maschine wie digna installieren:

Überprüfen Sie Ihre Architektur¶

Einige Pfade in dieser Anleitung unterscheiden zwischen Apple Silicon und Intel-Macs. Um Ihre Architektur zu prüfen, öffnen Sie das Terminal und führen Sie aus:

uname -m

• arm64 — Apple Silicon. Homebrew installiert sich nach /opt/homebrew.
• x86_64 — Intel. Homebrew installiert sich nach /usr/local.

Vorbereitungen vor der Installation¶

Bevor Sie digna installieren, stellen Sie sicher, dass drei zentralen Voraussetzungen erfüllt sind:

1. Homebrew – der Paketmanager, mit dem die untenstehenden Komponenten installiert werden
2. PostgreSQL-Server – zur Speicherung berechneter Metriken und Leistungsdaten
3. Webserver – zum Hosten des digna Dashboards

Falls diese Komponenten noch nicht eingerichtet sind, folgen Sie den nachfolgenden Abschnitten, um sie zu installieren und zu konfigurieren.

Homebrew installieren¶

Homebrew ist der Standard-Paketmanager für macOS und wird in dieser Anleitung verwendet, um PostgreSQL und nginx zu installieren.

Schritt 1: Prüfen, ob Homebrew bereits installiert ist¶

Öffnen Sie das Terminal (Cmd + Leertaste, tippen Sie Terminal, Enter) und führen Sie aus:

brew --version

Wenn eine Versionsnummer angezeigt wird, springen Sie zum Abschnitt PostgreSQL-Server einrichten.

Schritt 2: Homebrew installieren¶

Falls der Befehl nicht gefunden wurde, installieren Sie Homebrew, indem Sie den Anweisungen auf der offiziellen Homebrew-Seite folgen. Der Installer installiert auch die Xcode Command Line Tools, falls diese noch nicht vorhanden sind.

Schritt 3: Homebrew zu Ihrem PATH hinzufügen¶

Auf Apple Silicon gibt der Installer zwei Befehle aus, um Homebrew zur Shell-Umgebung hinzuzufügen. Führen Sie diese wie angegeben aus und prüfen Sie anschließend:

brew --prefix

Dies sollte auf Apple Silicon /opt/homebrew oder auf Intel /usr/local ausgeben.

PostgreSQL-Server einrichten¶

Falls Sie PostgreSQL bereits installiert haben¶

Wenn PostgreSQL bereits lokal läuft oder Sie eine verwaltete Remote-PostgreSQL-Instanz verwenden, können Sie zum nächsten Abschnitt springen.

Installationsoptionen¶

macOS bietet zwei unkomplizierte Wege, PostgreSQL zu installieren. Wählen Sie einen:

• Homebrew — Installation per Kommandozeile, empfohlen für Server-Deployments
• Postgres.app — grafische Installation, bequem für lokale Evaluierung

PostgreSQL mit Homebrew installieren¶

Schritt 1: Das PostgreSQL-Formula installieren¶

brew install postgresql@16

Schritt 2: PostgreSQL zu Ihrem PATH hinzufügen¶

Versionierte PostgreSQL-Formeln sind keg-only, das heißt, Homebrew verlinkt ihre Befehle nicht automatisch in Ihren PATH. Fügen Sie sie selbst hinzu:

echo 'export PATH="'$(brew --prefix)'/opt/postgresql@16/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Schritt 3: Den PostgreSQL-Dienst starten¶

brew services start postgresql@16

Dies startet PostgreSQL sofort und konfiguriert es so, dass es beim Einloggen automatisch wieder startet.

Schritt 4: Installation überprüfen¶

psql --version

Sie sollten die PostgreSQL-Version sehen, wenn die Installation erfolgreich war.

Schritt 5: Mit dem Server verbinden¶

psql postgres

Schritt 6: Den Port bestätigen¶

Der Standardport von PostgreSQL ist 5432. Um den Port zu bestätigen, auf dem Ihr Server lauscht:

psql postgres -c "SHOW port;"

Notieren Sie sich den Wert — Sie benötigen ihn bei der Konfiguration des digna-Backends.

PostgreSQL mit Postgres.app installieren¶

Wenn Sie eine grafische Installation bevorzugen:

1. Laden Sie Postgres.app herunter und ziehen Sie es in Ihren Applications-Ordner
2. Öffnen Sie die App und klicken Sie auf Initialize, um einen neuen Server zu erstellen
3. Folgen Sie den Anweisungen der App, um die Kommandozeilentools zu Ihrem PATH hinzuzufügen
4. Überprüfen Sie die Installation:

psql --version

Postgres.app legt ebenfalls einen Superuser mit dem Namen Ihres macOS-Benutzerkontos an.

Webserver-Konfiguration¶

digna benötigt einen Webserver, um das Dashboard zu hosten. Wählen Sie eine der folgenden Optionen:

• nginx — per Homebrew installiert, empfohlen
• Apache httpd — in macOS enthalten

Sie müssen nur einen dieser Server installieren und konfigurieren.

Beide Abschnitte konfigurieren zwei Dinge, die das Dashboard benötigt:

• Fallback für Single-Page-Applications, damit das Aktualisieren einer Dashboard-URL kein 404 zurückgibt
• Ein .md MIME-Typ, damit Markdown-Dateien korrekt ausgeliefert werden

nginx einrichten¶

Überblick¶

nginx ist ein leichtgewichtiger, leistungsfähiger Webserver, der sich gut eignet, um das statische digna-Dashboard zu servieren.

Installation¶

brew install nginx

nginx starten¶

brew services start nginx

Installation überprüfen¶

1. Öffnen Sie Ihren Browser
2. Rufen Sie http://localhost:8080 auf
3. Sie sollten die nginx-Willkommensseite sehen

Eine Site für das Dashboard konfigurieren¶

Die Homebrew-nginx-Konfiguration inkludiert alle Dateien im servers-Verzeichnis. Erstellen Sie dort eine dedizierte Konfigurationsdatei für digna:

nano $(brew --prefix)/etc/nginx/servers/digna.conf

Fügen Sie das Folgende ein und ersetzen Sie /path/to/digna/dashboard durch den tatsächlichen Pfad zu Ihrem entpackten dashboard-Ordner:

server {
    listen       8080;
    server_name  localhost;

    root   /path/to/digna/dashboard;
    index  index.html;

    # Serve Markdown files with the correct MIME type.
    types {
        text/markdown  md;
    }

    # Single-page-application fallback: unknown paths return index.html
    # instead of a 404, so dashboard routes survive a browser refresh.
    location / {
        try_files $uri $uri/ /index.html;
    }
}

Die Konfiguration anwenden¶

Prüfen Sie die Konfiguration auf Syntaxfehler und laden Sie nginx neu:

nginx -t
brew services restart nginx

Apache httpd einrichten¶

Überblick¶

macOS enthält Apache httpd, daher ist keine Installation erforderlich. Er ist standardmäßig deaktiviert.

Apache starten¶

sudo apachectl start

Installation überprüfen¶

1. Öffnen Sie Ihren Browser
2. Rufen Sie http://localhost auf
3. Sie sollten die Meldung "It works!" sehen

Erforderlich: mod_rewrite aktivieren¶

Das Dashboard benötigt URL-Rewriting. Öffnen Sie die Apache-Konfiguration:

sudo nano /etc/apache2/httpd.conf

Finden Sie folgende Zeile und entfernen Sie das vorangestellte #, um sie zu aktivieren:

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

Erforderlich: .htaccess-Overrides erlauben¶

Ändern Sie in derselben Datei den <Directory "/Library/WebServer/Documents">-Block von:

AllowOverride None

zu:

AllowOverride All

Erforderlich: MIME-Typ für Markdown-Dateien¶

Fügen Sie ebenfalls in httpd.conf die folgende Zeile hinzu, damit Markdown-Dateien korrekt ausgeliefert werden:

AddType text/markdown .md

Die Konfiguration anwenden¶

Überprüfen Sie die Konfiguration auf Syntaxfehler und starten Sie Apache neu:

sudo apachectl configtest
sudo apachectl restart

Erstinstallation¶

Schritt 1: Repository für digna einrichten¶

Das digna-Repository speichert alle von digna berechneten Metriken. Es fungiert als zentrale Datenbank für Analyse- und Leistungsdaten.

Schema und Benutzer anlegen¶

Öffnen Sie Ihren PostgreSQL-Client (psql, pgAdmin oder ähnliches) und führen Sie die folgenden SQL-Befehle aus:

CREATE SCHEMA <digna_repo_schema>;

CREATE USER <digna_repo_user> WITH PASSWORD '<digna_repo_password>';

GRANT ALL PRIVILEGES ON SCHEMA <digna_repo_schema> TO <digna_repo_user>;

Ersetzen Sie die folgenden Platzhalter:

• <digna_repo_schema> — Gewünschter Schema-Name (z. B. dignarepo)
• <digna_repo_user> — Gewünschter Benutzername (z. B. digna_user)
• <digna_repo_password> — Ein sicheres Passwort für diesen Benutzer

Beispiel:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

Um diese Befehle im Terminal in einem Schritt auszuführen:

psql postgres

Fügen Sie dann die Statements am postgres=# Prompt ein und geben Sie \q zum Beenden ein.

Schritt 2: Das digna-Installationspaket entpacken¶

1. Lokalisieren Sie die Ihnen bereitgestellte digna-Installations-ZIP-Datei
2. Entpacken Sie sie an Ihren gewünschten Installationsort — z. B. /opt/digna oder ~/digna
3. Nach dem Entpacken sollten Sie folgende Elemente sehen:
4. dashboard/ — Web-Dashboard-Oberfläche
5. digna — Haupt-Executable (Backend + CLI kombiniert)

Um im Terminal zu entpacken:

unzip digna-2026.11-macos.zip -d /opt/digna

Die ausführbare Datei ausführbar machen¶

Je nachdem, wie das Archiv übertragen wurde, geht das Ausführbarkeitsbit beim Entpacken möglicherweise verloren. Setzen Sie es explizit:

cd /opt/digna
chmod +x digna

Falls macOS die Anwendung blockiert¶

Per Browser oder Mail-Client heruntergeladene Dateien werden mit einem Quarantäne-Attribut versehen. Wenn macOS meldet, dass die App "cannot be opened because the developer cannot be verified", entfernen Sie das Attribut aus dem Installationsverzeichnis:

xattr -dr com.apple.quarantine /opt/digna

Alternativ öffnen Sie Systemeinstellungen → Datenschutz & Sicherheit, suchen das blockierte Element unten auf der Seite und klicken auf Dennoch öffnen / Open Anyway.

Schritt 3: Die Lizenzdatei installieren¶

1. Lokalisieren Sie die Ihnen bereitgestellte license.toml
2. Kopieren Sie sie in das Root-Installationsverzeichnis von digna (dort, wo config.toml und die digna-Executable liegen)

Warum das wichtig ist: Die Lizenzdatei enthält Ihre Kundendaten, das Ablaufdatum der Lizenz und die digitale Signatur. Ändern Sie diese Datei nicht — jede Änderung macht sie ungültig.

Verzeichnisstruktur nach der Einrichtung:

/opt/digna/
├── config.toml         (Konfigurationsdatei)
├── license.toml        (IHRE LIZENZDATEI - hierher kopieren)
├── digna               (Haupt-Executable)
├── bin/                (Skripte zur Service-Verwaltung)
└── dashboard/          (Weboberfläche)
    └── (Dashboard-Dateien)

Backend-Konfiguration¶

Schritt 1: Konfigurationsdatei anlegen und bearbeiten¶

Die Datei config_template.toml liegt in Ihrem digna-Installationsverzeichnis. Sie müssen sie lediglich in config.toml umbenennen.

cd /opt/digna
mv config_template.toml config.toml

Pfad: /opt/digna/config.toml

Öffnen Sie config.toml in einem Texteditor und konfigurieren Sie die nachstehenden Abschnitte.

[app] Abschnitt¶

Dieser Abschnitt konfiguriert Cross-Origin Resource Sharing (CORS) zwischen Dashboard und Backend:

[app]
DIGNA_APP_CORS_ALLOW_ORIGINS = ["http://localhost:5173"]
DIGNA_APP_CORS_ALLOW_CREDENTIALS = true

[repo] Abschnitt¶

Dieser Abschnitt konfiguriert die Verbindung zur PostgreSQL-Datenbank:

[repo]
DIGNA_REPO_HOST = "localhost"
DIGNA_REPO_PORT = 5432
DIGNA_REPO_DB = "postgres"
DIGNA_REPO_SCHEMA = "dignarepo"
DIGNA_REPO_USER = "digna_user"
DIGNA_REPO_PASSWORD = "YourSecurePassword123!"
DIGNA_REPO_SSLMODE = "prefer"
DIGNA_REPO_NUM_CONNS = 16

[base] Abschnitt¶

Dieser Abschnitt enthält Sicherheits-, Cookie- und Inspektionseinstellungen:

[base]
DIGNA_FERNET_KEY = "DU4a0yJ-OqvbKCL4hNQn_CsknH-V1vWmHZqBUl-AY44="
DIGNA_COOKIE_DOMAIN = "localhost"
DIGNA_COOKIE_SECURE = false
DIGNA_COOKIE_HTTPONLY = true
DIGNA_TOKEN_EXPIRES_IN = 86400
DIGNA_MAX_WORKERS = 4
DIGNA_FRONTEND_BASEURL = "http://localhost/"
DIGNA_SOURCE_QUERY_TIMEOUT_SEC = 3600
DIGNA_SOURCE_LOGIN_TIMEOUT_SEC = 30

[encryption] Abschnitt¶

Dieser Abschnitt enthält den Schlüssel, mit dem sensible Werte im Repository verschlüsselt werden. Er ist erforderlich — config check meldet den Abschnitt [encryption] als FAILED, wenn der Schlüssel fehlt.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

[logging] Abschnitt¶

Dieser Abschnitt konfiguriert das Logging-Verhalten:

[logging]
DIGNA_LOGGING_MODE = "INFO"
DIGNA_LOGGING_DIR = "logs"
DIGNA_LOGGING_MAX_FILES = 30

[duckdb] Abschnitt (optional)¶

Neu in Release 2026.11. Dieser Abschnitt legt die Ressourcen der digna Engine fest, die für Datenbankverbindungen mit dem Profiling-Ort digna Engine Daten innerhalb von digna profiliert und Prüfungen der referenziellen Integrität zwischen Datenquellen auf unterschiedlichen Datenbankverbindungen ausführt. Siehe Profiling-Ort.

Der Abschnitt ist optional. Ohne ihn gelten die unten genannten Standardwerte.

[duckdb]
DIGNA_DUCKDB_MEMORY_LIMIT_MB = 1024
DIGNA_DUCKDB_TEMP_DIRECTORY = "/opt/digna/tmp"

mkdir -p /opt/digna/tmp

Schritt 2: Konfiguration prüfen¶

Prüfen Sie vor der Initialisierung des Repositories, ob config.toml vollständig und korrekt aufgebaut ist. Führen Sie in Ihrem digna-Installationsverzeichnis aus:

./digna config check

Jeder Abschnitt wird einzeln geprüft, sodass ein einzelner Fehler den Zustand der übrigen nicht verdeckt:

Configuration validation report (source: config.toml):
 - App config: OK
 - Repository config: OK
 - Base config: OK
 - Logging config: OK
 - Encryption config: OK
 - OIDC config(s): OK
 - Template overrides: OK
 - Unknown keys: OK

Overall: OK

Beheben Sie alles, was als FAILED gemeldet wird, und führen Sie den Befehl erneut aus, bevor Sie fortfahren. Eine WARNING unter Unknown keys listet Schlüssel in der config.toml auf, die digna nicht liest; sie haben keine Wirkung, entfernen Sie sie also oder korrigieren Sie ihre Schreibweise. Die vollständige Liste der Optionen finden Sie in der CLI-Referenz.

Schritt 3: Das Repository initialisieren¶

1. Öffnen Sie das Terminal
2. Wechseln Sie in Ihr digna-Installationsverzeichnis (dort, wo config.toml und die digna-Executable liegen)
3. Führen Sie den Verbindungstest aus:

cd /opt/digna
./digna repo check

Bei einem neuen Schema stellt der Befehl die Verbindung her und meldet dann, dass noch kein Repository installiert ist:

Error: No repo installed. Use the 'digna repo upgrade' command to install it.

An dieser Stelle ist das das erwartete Ergebnis: Es bestätigt, dass digna PostgreSQL und das Schema erreicht. Ein Verbindungs- oder Authentifizierungsfehler weist dagegen auf den Abschnitt [repo] oder auf die PostgreSQL-Einrichtung hin.

echo 'export PATH="/opt/digna:$PATH"' >> ~/.zshrc
source ~/.zshrc

Schritt 4: Das Repository-Schema installieren¶

Führen Sie im selben Verzeichnis aus:

./digna repo upgrade

Dieser Befehl legt die benötigten Tabellen im Repository-Schema an und endet mit:

✅ Repo schema 'dignarepo' is up to date.

Schritt 5: Einen Admin-Benutzer anlegen¶

1. Öffnen Sie ein neues Terminalfenster
2. Wechseln Sie in Ihr digna-Installationsverzeichnis
3. Führen Sie folgenden Befehl aus, um einen Admin-Benutzer zu erstellen:

./digna user add <email> <password> "<display_name>" --admin

Beispiel:

./digna user add admin@example.com 'AdminPassword123!' "Admin User" --admin

Dies legt einen Benutzer mit der E-Mail-Adresse admin@example.com und vollen administrativen Rechten an.

Schritt 6: Den digna-Server starten¶

Starten Sie im digna-Installationsverzeichnis den Server mit:

./digna serve --address <host> --port <port>

Parameter: - --address — Server-Hostname/IP (Standard 127.0.0.1) - --port — Server-Port (Standard 8000)

Sobald der Server läuft, gibt er die Adresse aus, auf der er lauscht:

Server running on http://127.0.0.1:8082

Dashboard-Konfiguration¶

Schritt 1: Dashboard auf dem Webserver bereitstellen¶

Das digna-Dashboard liest seine eigene Konfiguration aus dashboard/dashboard_config.toml. Diese Datei wird nicht mit der Installation ausgeliefert — Sie legen sie im dashboard/-Verzeichnis neben den Dashboard-Dateien an.

Ihr Inhalt ist unter Single Sign-on beschrieben, wo die Datei auch benötigt wird: Sie enthält die Anmeldeoptionen, die das Dashboard anbietet, und bei Multi-Instance-Deployments die Backend-Verbindung.

Wählen Sie Ihren Webserver und folgen Sie den entsprechenden Bereitstellungsschritten.

Bereitstellung auf nginx¶

Wenn Sie der Anleitung im Abschnitt nginx Setup gefolgt sind, zeigt der Server-Block bereits auf Ihren dashboard-Ordner und es ist kein Kopieren erforderlich.

1. Pfad bestätigen
2. Öffnen Sie $(brew --prefix)/etc/nginx/servers/digna.conf

3. Vergewissern Sie sich, dass root auf Ihren entpackten dashboard-Ordner zeigt

4. Sicherstellen, dass der Ordner lesbar ist

   chmod -R a+rX /opt/digna/dashboard
   

5. nginx neu laden

   nginx -t
   brew services restart nginx
   

6. Installation testen

7. Öffnen Sie Ihren Browser
8. Rufen Sie http://localhost:8080 (oder Ihre konfigurierte URL) auf
9. Sie sollten die Anmeldeseite des digna-Dashboards sehen

Bereitstellung auf Apache httpd¶

1. Dashboard in das Document Root kopieren

   sudo cp -R /opt/digna/dashboard /Library/WebServer/Documents/digna
   

2. Rewrite-Regeln hinzufügen

Erstellen Sie eine .htaccess-Datei im bereitgestellten Ordner, damit Dashboard-Routen beim Browser-Refresh erhalten bleiben:

sudo nano /Library/WebServer/Documents/digna/.htaccess

Fügen Sie Folgendes ein:

RewriteEngine On
RewriteBase /digna/

# Serve existing files and directories as-is.
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]

# Everything else falls back to the single-page application entry point.
RewriteRule ^ index.html [L]

1. Apache neu starten

   sudo apachectl restart
   

2. Dashboard aufrufen

3. Öffnen Sie Ihren Browser
4. Rufen Sie http://localhost/digna auf
5. Sie sollten die Anmeldeseite des digna-Dashboards sehen

digna als Hintergrunddienst ausführen¶

Warum digna als Dienst ausführen?¶

Das Ausführen des digna-Backends als Hintergrunddienst stellt sicher, dass es:

• Beim Systemstart automatisch gestartet wird
• Im Hintergrund läuft, ohne ein offenes Terminalfenster zu benötigen
• Bei Abstürzen automatisch neu startet
• Über launchctl, den Dienstemanager von macOS, verwaltet werden kann

Dateien zur Dienstverwaltung¶

Alle benötigten Dateien befinden sich im digna-Installationsverzeichnis unter: bin/

Die folgenden Shell-Skripte sind vorhanden:

• install_service.sh — registriert digna bei launchd
• uninstall_service.sh — entfernt die Registrierung
• start_service.sh — startet den registrierten Dienst
• stop_service.sh — stoppt den laufenden Dienst

Ausführbarkeitsrechte für die Skripte setzen¶

Beim Entpacken kann das Ausführbarkeitsbit verloren gehen. Vor der ersten Verwendung:

cd /opt/digna/bin
chmod +x *.sh

Dienst installieren¶

1. Terminal öffnen

2. Ins bin-Verzeichnis wechseln

   cd /opt/digna/bin
   

3. Installationsskript ausführen

   sudo ./install_service.sh
   

Der digna-Server ist jetzt bei launchd mit automatischem Start registriert. Der Dienst startet nicht sofort — siehe den nächsten Abschnitt, um ihn zu starten.

Dienst starten und stoppen¶

Dienst starten¶

1. Terminal öffnen
2. Ins Verzeichnis /opt/digna/bin wechseln
3. Ausführen:

   sudo ./start_service.sh
   

Dienst stoppen¶

1. Terminal öffnen
2. Ins Verzeichnis /opt/digna/bin wechseln
3. Ausführen:

   sudo ./stop_service.sh
   

Dienst verifizieren¶

Um zu bestätigen, dass der Dienst registriert und läuft:

sudo launchctl list | grep digna

Eine Zeile, die mit einer Prozess-ID beginnt, zeigt an, dass der Dienst läuft. Ein - in der ersten Spalte bedeutet, dass er registriert, aber gestoppt ist.

Dienst in ein neues Verzeichnis verschieben¶

launchd speichert den absoluten Pfad zur ausführbaren Datei, daher erfordert ein Verschieben der Installation eine Neu-Registrierung des Dienstes:

1. Aktuellen Dienst deinstallieren

   cd /old/path/digna/bin
   sudo ./uninstall_service.sh
   

2. Anwendungsdateien verschieben

   sudo mv /old/path/digna /new/path/digna
   

3. Dienst neu installieren

   cd /new/path/digna/bin
   sudo ./install_service.sh
   

4. Dienst starten

   sudo ./start_service.sh
   

Dienst deinstallieren¶

1. Laufenden Dienst stoppen

   cd /opt/digna/bin
   sudo ./stop_service.sh
   

2. Dienst deinstallieren

   sudo ./uninstall_service.sh
   

Der digna-Server ist nun bei launchd abgemeldet.

Upgrade auf eine neue Version¶

Dieser Abschnitt beschreibt das Upgrade einer Installation von Release 2026.06 auf Release 2026.11. Ist Ihre Installation älter, lesen Sie zuerst Upgrade von einem Release vor 2026.06.

Bevor Sie ein Upgrade durchführen¶

Ein Backup des digna-Repositorys ist verpflichtend

Erstellen Sie vor einem Upgrade von digna ein Backup Ihres Repositorys (PostgreSQL), um Datenverlust zu vermeiden. Ein Backup stellt sicher, dass Sie im Falle unerwarteter Probleme bei einem Upgrade wiederherstellen können.

Um ein Backup im Terminal zu erstellen:

pg_dump -h localhost -p 5432 -U digna_user -n dignarepo postgres > digna_repo_backup.sql

Lizenzdatei für Release 2026.11 anfordern

Release 2026.11 benötigt eine neue license.toml. Fordern Sie sie vor dem Start beim digna-Team an und halten Sie sie für Schritt 7 bereit.

Upgrade von einem Release vor 2026.06¶

Release 2026.06 brachte drei Änderungen, die weiterhin gelten, wenn Sie eine ältere Installation direkt auf 2026.11 aktualisieren:

• Nur ODBC. digna erreicht jede Quelltechnologie über ODBC. Jede Datenbankverbindung, die noch kein ODBC verwendet, muss nach dem Upgrade auf ODBC umgestellt werden; eine automatische Umwandlung gibt es nicht. Installieren Sie die ODBC-Treiber vorab auf dem digna-Host, siehe ODBC-Treiber auf dem digna-Host installieren, und halten Sie die Eigenschaften jeder Verbindung aus den Technologie-Anleitungen bereit. Den Databricks-Legacy-Connector gibt es nicht mehr; stellen Sie diese Verbindungen auf den Databricks-Connector um.
• Eine ausführbare Datei. dignabackend und dignacli werden durch die einzelne ausführbare Datei digna ersetzt, die Backend und CLI vereint.
• config.toml. Der Abschnitt [encryption] ist erforderlich, und DIGNA_APP_HOST und DIGNA_APP_PORT werden nicht mehr gelesen: Adresse und Port bezieht der Server von digna serve. Vergleichen Sie Ihre Datei mit der Backend-Konfiguration.

Die folgenden Schritte weisen darauf hin, wo eine ältere Installation etwas anderes benötigt. Das Repository-Upgrade in Schritt 8 bringt ein Repository jedes früheren Releases direkt auf 2026.11.

Upgrade-Ablauf¶

Schritt 1: digna-Dienst stoppen¶

Wenn digna als Hintergrunddienst läuft, stoppen Sie ihn zuerst:

cd /opt/digna/bin
sudo ./stop_service.sh

Falls digna im Vordergrund läuft, drücken Sie in dessen Terminal-Fenster Ctrl+C.

Schritt 2: Aktuelle Installation sichern¶

Benennen Sie in Ihrem digna-Installationsverzeichnis die ausführbare Datei und den Dashboard-Ordner Ihrer aktuellen Installation um, damit das neue Release daneben bereitgestellt werden kann:

cd /opt/digna
mv digna digna_old
mv dashboard dashboard_old

Behalten Sie digna_old, bis Sie das Upgrade überprüft haben, und dashboard_old, bis Sie Ihre Konfigurationsdateien daraus wiederhergestellt haben (siehe Schritt 4). Danach können Sie beide löschen.

Schritt 3: Neue Version entpacken und bereitstellen¶

1. Entpacken Sie die neue digna-Installations-ZIP-Datei
2. Kopieren Sie die neue digna-Executable und den dashboard-Ordner in Ihr Installationsverzeichnis
3. Stellen Sie das Executable-Bit wieder her und entfernen Sie bei Bedarf das Quarantäne-Attribut:

chmod +x /opt/digna/digna
xattr -dr com.apple.quarantine /opt/digna

Schritt 4: Konfigurationsdateien wiederherstellen¶

cp dashboard_old/dashboard_config.toml dashboard/dashboard_config.toml

Release 2026.11 erfordert keine Änderung an der config.toml: Eine Datei, die mit Release 2026.06 funktioniert, funktioniert weiterhin. Zwei Änderungen sind optional:

• Ergänzen Sie einen Abschnitt [duckdb], wenn Datenbankverbindungen die digna Engine verwenden sollen und deren Standardwerte nicht zu Ihrem Host passen.
• Lassen Sie den Abschnitt [app] weg, wenn ein Reverse Proxy Dashboard und Backend unter einer Origin ausliefert.

[[oidc_clients]]
DIGNA_OIDC_KEY = 'microsoft'
DIGNA_OIDC_CLIENT_ID = '<client_id>'
DIGNA_OIDC_CLIENT_SECRET = '<client_secret>'
DIGNA_OIDC_REDIRECT_URI = 'http://localhost:3000/oidc/callback'
DIGNA_OIDC_CONFIGURATION_URL = 'https://login.microsoftonline.com/<tenant_id>/v2.0/.well-known/openid-configuration'

Schritt 5: Webserver neu laden¶

Das Dashboard besteht aus statischen Dateien, daher liefern Ihr Webserver — und der Browser — möglicherweise noch die vorherige Version aus. Laden Sie den Webserver, der den dashboard-Ordner bereitstellt, neu oder starten Sie ihn neu, und laden Sie die Seite anschließend mit einem Hard Refresh neu (Cmd+Shift+R).

Schritt 6: Konfiguration prüfen¶

Stellen Sie sicher, dass die config.toml vollständig ist, bevor Sie das Repository anfassen:

./digna config check

Jeder Abschnitt muss OK melden. Beheben Sie alles, was als FAILED gemeldet wird, entfernen Sie die unter Unknown keys aufgeführten Schlüssel und führen Sie den Befehl erneut aus, bevor Sie fortfahren.

Schritt 7: Lizenzdatei ersetzen¶

Eine Lizenzdatei gilt normalerweise von einem Release zum nächsten weiter. Release 2026.11 ist eine Ausnahme: Es fügt zwei lizenzierte Module hinzu, digna Data Reconciliation und digna Agentic, und eine vor 2026.11 ausgestellte Lizenz enthält sie nicht. Kopieren Sie die license.toml, die das digna-Team für Release 2026.11 bereitgestellt hat, in das Installationsverzeichnis und ersetzen Sie damit die alte:

cp /path/to/new/license.toml /opt/digna/license.toml

./digna license check

Schritt 8: Repository-Schema upgraden¶

Führen Sie in Ihrem digna-Installationsverzeichnis aus:

cd /opt/digna
./digna repo upgrade

Release 2026.11 verwaltet das Repository-Schema mit versionierten Migrationen. Das erste Upgrade von einem früheren Release bringt das Schema auf die letzte Version des bisherigen Verfahrens, hält diesen Stand als Ausgangspunkt fest und wendet dann die Migrationen von Release 2026.11 an. Es endet mit:

✅ Baseline migration recorded as applied.
✅ Repo schema 'dignarepo' is up to date.

Alle vorhandenen Daten bleiben erhalten. Um den Zustand des Repositorys jederzeit zu sehen, führen Sie ./digna repo check aus: Der Befehl listet die zuletzt angewendete Migration und alle noch ausstehenden auf.

Error: Legacy repo version 3.0.2 installed. Use the 'digna repo upgrade' command to upgrade it.

Schritt 9: Dienste neu starten¶

Wenn digna als Hintergrunddienst läuft:

cd /opt/digna/bin
sudo ./start_service.sh

Wenn Sie es manuell betreiben, starten Sie den Server neu:

cd /opt/digna
./digna serve --address <address> --port <port>

Wenn Sie nginx oder Apache verwenden, starten Sie den jeweiligen Webserver neu:

brew services restart nginx

sudo apachectl restart

Schritt 10: Upgrade verifizieren¶

1. Prüfen Sie das Release der neuen ausführbaren Datei:

   ./digna version
   

   Die erste Zeile muss Release: 2026.11 lauten.

2. Rufen Sie das digna-Dashboard auf und prüfen Sie, ob die Oberfläche korrekt geladen wird.

3. Prüfen Sie die Ausgabe des Servers und die Dateien im Verzeichnis logs auf Fehler.
4. Testen Sie Ihre Datenbankverbindungen — siehe Verbindung testen. Nach einem Upgrade von einem Release vor 2026.06 stellen Sie zuvor jede Verbindung, die noch kein ODBC verwendet hat, auf ODBC um.

Für den Einstieg in die neuen Module siehe digna Data Reconciliation, KI-Agenten verbinden für den digna MCP Server und Profiling-Ort für die digna Engine.