TPT Aegis

Ultra-lightweight, API-first Identity & Access Management, built in Rust. See spec.txt for the product vision and docs/architecture.md for the technical plan. todo.md tracks build progress.

Dev setup

Copy the env file:

cp .env.example .env

Option A: Docker

docker compose up -d

Option B: Native Postgres + Redis

Install PostgreSQL and Redis (or a Redis-compatible service such as Memurai on Windows) locally, create a database/user matching .env, and make sure both are running before starting the server. No code changes are needed — the server only reads DATABASE_URL / REDIS_URL.

Running

cargo run -p server

On first boot, if no admin user exists, one is created from SEED_ADMIN_EMAIL / SEED_ADMIN_PASSWORD.

Frontend

cd frontend
npm install
npm run dev

Tests

cargo test --workspace

Integration tests in crates/store and crates/server require a real Postgres + Redis (Docker or native) — either docker compose up -d running, or TEST_DATABASE_URL / TEST_REDIS_URL pointed at a native instance.