Quickstart
This quickstart takes you from zero to a running AthenaDB instance with an active trial license. AthenaDB is in Early Access — evaluate on non-sensitive data until the external audit that gates real customer data completes.
1. Create an account and start a trial
Register on the portal and start a trial. The portal issues a 180-day trial license bound to your account against the live activation edge, and shows the live window on your dashboard.
2. Install the CLI
Download the athenadb CLI for your platform and confirm it runs:
athenadb --version
3. Activate this device
Activate with the trial or license key from your dashboard. Activation contacts
the live edge at license.athenadb.app:
athenadb db license activate <your-key>
Check the trial window and activation count at any time:
athenadb db license trial status
4. Ingest and query
Create an instance, ingest a document, and run a hybrid query that blends keyword and semantic retrieval:
athenadb db init ./my-instance
athenadb ingest ./my-instance ./docs/*.md
athenadb legal query ./my-instance "how does activation work?"
Retrieval runs through a domain pack, so the query subcommand is the pack's —
legal, medical, or research. See Domain packs.
Next steps
- Read the architecture overview.
- Understand the security model.
- Learn how licensing and activation work.

