Installation
Install and run Athena locally for development.
Prerequisites
- Rust
1.85+ - Docker (recommended for local Postgres/Redis)
- Optional:
pg_dumpandpg_restorefor backup/restore workflows
1. Clone and Build
git clone https://github.com/<your-org>/athena.git
cd athena
cargo build --release2. Configure Environment
Create .env with at least the logging client URI:
POSTGRES_ATHENA_LOGGING_URI=postgres://athena:athena@localhost:5433/athena_loggingIf your environment provides non-Linux paths for Postgres tools, override:
ATHENA_PG_DUMP_PATH=/usr/bin/pg_dump
ATHENA_PG_RESTORE_PATH=/usr/bin/pg_restore3. Start Local Dependencies
docker compose up -d postgres4. Run Athena API
cargo run -- --api-onlyDefault API port is 4052.
5. Verify Health
curl http://localhost:4052/ping
curl http://localhost:4052/health/clusterOptional: Run Web Explorer
The apps/web Next.js app can be started against your local Athena instance:
cd apps/web
pnpm install
NEXT_PUBLIC_ATHENA_BASE_URL=http://localhost:4052 \
NEXT_PUBLIC_ATHENA_CLIENT=athena_logging \
pnpm dev