Install
AthenaDB is a native database — it installs and runs directly on your operating system. Windows, macOS, Linux, FreeBSD, and Solaris are first-class Early Access targets. IBM AIX is a Planned native Unix lane — no install commands yet. See Platforms for status honesty and the platforms page for the product overview.
You can install the way you prefer: a graphical installer for a guided setup, your package manager, or the command line for automation. Package repositories and signed/notarized installers continue to land with release evidence — prefer the artifacts published for your trial.
Linux
AthenaDB builds and tests for named Linux distributions, each on x86_64 and arm64 — not a generic “Linux” catch-all:
| Distribution | Package | Manager | | --- | --- | --- | | Debian | DEB | apt | | Ubuntu | DEB | apt | | Red Hat Enterprise Linux | RPM | dnf | | Fedora | RPM | dnf | | openSUSE | RPM | zypper | | SUSE Linux Enterprise | RPM | zypper |
openSUSE and SUSE Linux Enterprise share the SUSE RPM/zypper lane (parallel to Fedora alongside RHEL). See Platforms for the full matrix.
Debian / Ubuntu (apt):
sudo apt install athenadb
athenadb --version
Red Hat Enterprise Linux / Fedora (dnf):
sudo dnf install athenadb
athenadb --version
openSUSE / SUSE Linux Enterprise (zypper):
sudo zypper install athenadb
athenadb --version
To install a downloaded package file directly:
sudo dnf install ./athenadb-<version>.el9.x86_64.rpm # RHEL/Fedora example
Solaris
AthenaDB targets Oracle Solaris 11.4 natively with IPS packaging.
sudo pkg install -g ./athenadb-<version>.p5p athenadb
athenadb --version
A portable tarball is also available if you would rather not install a package.
Windows
AthenaDB runs natively on Windows Desktop and Windows Server.
- Graphical installer — download and run it.
- Command line — for admins and automation.
athenadb --version
Windows-native secure key storage is part of the custody model. Active Directory / Entra ID directory join is planned — not a current Early Access claim. DB-native RBAC is available for evaluation; see Identity & access.
FreeBSD
AthenaDB targets FreeBSD 15 natively with pkg distribution.
sudo pkg add ./AthenaDB-<version>-FreeBSD.pkg
athenadb --version
IBM AIX (Planned)
AthenaDB is being built for IBM AIX as a first-class native Unix target.
There is no published installer or package command yet — do not treat AIX as
Early Access until a registry aix-* lane and artifacts exist. Watch
Platforms for status.
macOS
AthenaDB targets Apple Silicon and Intel macOS natively. Signed PKG installers and Apple notarization are the packaging goals; treat notarized public installers as pending verified supply-chain evidence rather than a shipping claim.
sudo installer -pkg AthenaDB-<version>-arm64.pkg -target /
athenadb --version
Keychain-backed key custody is the intended macOS custody model.
Connecting to a server
AthenaDB Server accepts connections with a familiar default port and a choice of transports:
- TCP/IP on default port 1440 (configurable), secured with TLS.
- Local connections over a named pipe on Windows, or a Unix domain socket on macOS, Linux, FreeBSD, and Solaris.
OS-identity → database-principal reconciliation on every path is still completing. See Connectivity.
Next
- Quickstart — your first vault and query.
- CLI reference — the full command surface.
- A–Z index — the full product map.

