.NET

Installation

OmniDB bietet 2 Arten von Paketen, um jeden Anwendungsfall abzudecken:

Sowohl die Anwendung als auch der Server können auf derselben Maschine installiert werden.

OmniDB Application

Wichtig: Das ursprüngliche Repository https://github.com/OmniDB/OmniDB/releases enthält nur alte Versionen (bis ca. 2020) und wird nicht mehr gepflegt — was sich seitdem geändert hat, erfahren Sie unter Legacy-Funktionen & Historie.

Für aktuelle Versionen nutzen Sie die Releases-Seite des Projekts. Seit der Umstellung auf Go ist jedes Release ein einziges, in sich geschlossenes Archiv pro Plattform (plus ein optionaler Installer für Windows) — keine separat zu installierende Laufzeitumgebung:

Entpacken Sie das Archiv für Ihre Plattform und führen Sie die darin enthaltene OmniDB-App bzw. Binärdatei aus — das ist die gesamte Installation.

Installation über Homebrew (nur macOS – empfohlen)

Für macOS-Benutzer, die einen Paketmanager bevorzugen, ist OmniDB über einen eigenen Homebrew-Tap verfügbar:

# Die neueste Version installieren:
brew install --cask heptau/tap/omnidb
# Später aktualisieren:
brew upgrade heptau/tap/omnidb

Homebrew lädt automatisch das passende ZIP für Ihre Architektur (Apple Silicon oder Intel) herunter, entpackt es und legt OmniDB.app in Ihrem Programme-Ordner ab.

Die Cask-Definition wird hier gepflegt: heptau/homebrew-tap – omnidb.rb

Installation über winget (nur Windows)

Für Windows-Benutzer, die einen Paketmanager bevorzugen, ist OmniDB über den Windows Package Manager verfügbar, der in Windows 10 und 11 bereits enthalten ist:

# Die neueste Version installieren:
winget install heptau.OmniDB
# Später aktualisieren:
winget upgrade heptau.OmniDB

Das Manifest wird hier gepflegt: microsoft/winget-pkgs.

Direkter Download (alle Plattformen)

Diese Links verweisen immer auf die neueste Version. Ältere Versionen, Prüfsummen und Release Notes finden Sie auf der Releases-Seite.

Entpacken Sie das Archiv für Ihre Plattform und starten Sie die App auf dem üblichen Weg: unter macOS ziehen Sie OmniDB.app in den Ordner Programme und öffnen sie über Launchpad/Spotlight oder open -a OmniDB; unter Linux führen Sie die Binärdatei OmniDB direkt aus; unter Windows führen Sie OmniDB.exe (oder den Installer) aus.

Wo die App ihre Daten ablegt, ihre Menüleiste und Tastenkürzel sowie macOS-Besonderheiten wie den Import von Daten aus einer früheren Installation beschreibt das Kapitel Desktop-App.

OmniDB Server

Dasselbe Release-Archiv enthält auch omnidb-server — eine separate, kopflose Binärdatei neben der Desktop-App (die Desktop-App startet intern tatsächlich dieselbe Binärdatei als Kindprozess und erzwingt so den App-Modus). Führen Sie sie direkt aus, um den per Browser erreichbaren Server-Modus zu erhalten, ganz ohne Desktop-Shell:

user@machine:~$ ./omnidb-server
omnidb-server: listening on 127.0.0.1:52149 — open http://127.0.0.1:52149/omnidb_login/ in your browser

Standardmäßig lauscht OmniDB nur auf 127.0.0.1 und wählt automatisch einen freien Port. Sie können beides explizit angeben:

user@machine:~$ ./omnidb-server -p 8080 -H 0.0.0.0
omnidb-server: listening on 0.0.0.0:8080 — open http://0.0.0.0:8080/omnidb_login/ in your browser

Den vollständigen Satz an Optionen sowie empfohlene Deployment-Setups finden Sie unter omnidb-server bereitstellen (insbesondere, warum es nicht empfohlen wird, -H 0.0.0.0 ohne vorgeschalteten Reverse-Proxy direkt dem Internet auszusetzen — es gibt keine eingebaute TLS-Unterstützung).

OmniDB mit Oracle

Weder die OmniDB-App noch der Server benötigen zusätzliche Software, um sich mit Oracle zu verbinden — anders als bei früheren Releases ist keine separate Installation des Oracle Instant Client erforderlich. Die Oracle-Konnektivität ist nativ implementiert (ein reiner Go-Treiber), sodass sie von Haus aus genauso funktioniert wie bei jeder anderen unterstützten Datenbank. Das Gleiche gilt für MS SQL Server und Firebird: Beide verwenden ebenfalls reine Go-Treiber, sodass auch hier kein ODBC-Treiber, keine native Client-Bibliothek und kein weiterer Installationsschritt nötig ist.

OmniDB-Benutzerdatenbank

Beim ersten Start legen sowohl Server als auch App im Home-Verzeichnis des Benutzers die Datei ~/.omnidb/omnidb-app/omnidb.db (für die OmniDB-App) bzw. ~/.omnidb/omnidb-server/omnidb.db (für den OmniDB-Server) an, sofern sie noch nicht existiert — zusammen mit einem Superuser-Konto admin. Die Desktop-App meldet sich automatisch mit diesem Benutzer an; im Server-Modus wird sein Passwort zufällig erzeugt und einmalig in die Log-Ausgabe des Servers geschrieben (die Zeile mit initial login: admin / …). Diese Datei wird auch als Benutzerdatenbank bezeichnet und enthält alle Benutzer, Verbindungen und sonstigen Anwendungsdaten. Existiert sie bereits (z. B. nach einem Upgrade), verwendet OmniDB sie unverändert weiter — sie wird nie automatisch überschrieben oder zurückgesetzt.

OmniDB im Browser

Sobald omnidb-server läuft, öffnen Sie die Adresse, die er beim Start ausgegeben hat (zum Beispiel http://127.0.0.1:52149/omnidb_login/), in Ihrem bevorzugten Browser. Sie sehen die Anmeldeseite von OmniDB; melden Sie sich als admin mit dem einmaligen Passwort aus dem Log an. In den nächsten Kapiteln sehen wir, wie man Benutzer und Verbindungen erstellt und mit OmniDB arbeitet. Die Desktop-App überspringt diesen Schritt vollständig — sie öffnet direkt den Arbeitsbereich.