Installation

Choose a language and storage backend, then apply the matching migrations.

Headgate separates its runtime from database drivers. Install only the adapter your service uses. PostgreSQL is the reference backend; MySQL and Redis share the core admission contract.

Packages

Rust

Cargo.toml

[dependencies]
headgate = "0.1"
headgate-postgres = "0.1" # or headgate-mysql / headgate-redis
# Optional: headgate-workflow, headgate-crypto, headgate-otel, headgate-ui
serde = { version = "1", features = ["derive"] }
tokio = { version = "1", features = ["rt-multi-thread", "macros"] }

Go

go get github.com/mujhtech/headgate/go
go get github.com/mujhtech/headgate/go/driver/headgatepgx
# or driver/headgatemysql / driver/headgateredis
# Optional standalone modules:
# go get github.com/mujhtech/headgate/go/headgateworkflow
# go get github.com/mujhtech/headgate/go/headgatecrypto

Choose a backend

Backend	Best fit	Optional capabilities
PostgreSQL	Reference deployment and transactional application work	Transactions, inspection, notifications
MySQL	Existing MySQL infrastructure	Transactions and inspection; polling only
Redis	Low-latency Redis-native fleets	Atomic Lua admission; no SQL transactions

Run migrations before workers or the control API. Do not apply individual migration files manually or copy SQL between languages; the migration libraries embed verified assets.

Continue

PostgreSQL

MySQL

Redis