domainhawk

A hawk's eye on every domain you want.

domainhawk is a small, self-hosted domain watchlist. Add a domain and it checks the registry every four hours, emailing you once the name becomes available. It also reads registration and expiry details from RDAP, warns you before a registered name expires, and flags drop-related registry states. The UI is server-rendered with HTMX, availability comes from authoritative RDAP with a WHOIS fallback, and data, users and auth live in an embedded PocketBase.

Quick start

go run . serve --http=127.0.0.1:8090 --dir=./pb_data

Open http://127.0.0.1:8090. On a fresh data directory PocketBase asks you to create a superuser; the dashboard is available at /_/.

For local development without an identity provider, enable the password form and seed a user:

export DH_APP_URL=http://127.0.0.1:8090
export DH_PASSWORD_AUTH=true
export DH_SEED_EMAIL=you@example.com
export DH_SEED_PASSWORD='a-long-dev-password'
go run . serve --http=127.0.0.1:8090 --dir=./pb_data

DH_SEED_* is intended for development and tests. Remove it in production.

Documentation

The full documentation is embedded in the binary and served at /docs.

Guide	What it covers
User docs	User guide and API reference.
Operations	Configuration, OIDC, availability semantics, production and Docker.
Development	Tests, build tags, project layout and stack.

License

No license file is included yet. Add one before distributing.