Sovereign 8s.is mirror of 8b-is/ayeHeadscale
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-10-21 09:27:30 -04:00
src fix: give exhausted tailnet addresses a pool break (#1) 2026-10-20 00:22:58 +09:00
tests fix: give exhausted tailnet addresses a pool break (#1) 2026-10-20 00:22:58 +09:00
.gitignore chore: ignore cargo target/ directory 2026-10-21 09:27:30 -04:00
Cargo.lock ayeHeadscale: the fleet's own tailnet, in Rust 2026-09-22 07:04:56 -04:00
Cargo.toml ayeHeadscale: the fleet's own tailnet, in Rust 2026-09-22 07:04:56 -04:00
config.yaml ayeHeadscale: the fleet's own tailnet, in Rust 2026-09-22 07:04:56 -04:00
docker-compose.yml ayeHeadscale: the fleet's own tailnet, in Rust 2026-09-22 07:04:56 -04:00
README.md fix: give exhausted tailnet addresses a pool break (#1) 2026-10-20 00:22:58 +09:00

ayeHeadscale

the fleet's own tailnet — Headscale, named aye, self-hosted so the coordination server is the fleet's, not the cloud's. "fine touch from within", applied to the network.

why

the motor's swe_af fanout died because the Mac dropped off the Tailscale cloud (coordination server unreachable, backend NoState). ayeHeadscale moves the control plane in-house: the fleet owns its own coordination, so "logged out" stops being a wall someone else owns.

run (docker)

docker compose up -d
docker compose exec headscale headscale users create fleet
docker compose exec headscale headscale preauthkeys create --user fleet

point a node at it:

tailscale up --login-server https://headscale.vaked.dev

the layers

layer what it holds
server_url the coordination endpoint the nodes dial
prefixes (100.64.0.0/10) the CGNAT space the tailnet lives in
magic dns *.vaked.dev names for every node, resolved by the fleet
sqlite the state, one file — the ledger of the tailnet

Rust prototype

The Rust crate is a separate in-memory admission and address-allocation model. It does not run the Headscale service, read config.yaml, implement a tailnet protocol, or persist keys and nodes. The Docker instructions above run upstream Headscale instead.

Use one Coordinator instance to issue a synthetic key and register nodes in library tests. Each Rust CLI invocation creates a fresh coordinator: key does not authorize a later join process, and list starts empty. A refused join writes its reason to stderr and exits with status 1.

Coordinator::default() and Coordinator::new() both start at 100.64.0.1. Registration refuses an exhausted 100.64.0.0/10 pool without adding a node. Run the offline prototype tests with cargo test --locked --offline.

ayeheadscale · the fleet's own tailnet · fine touch from within · vaked.dev · 8b-is