Skip to content
Whalenet
Skip navigation
View as Markdown

Whalenet

Inspect and govern the fleet you already run, where every member holds a routable address anyone can verify.

Published

In this chapter

Whalenet Documentation

Whalenet is the mesh between the machines and agents you already run: servers, containers and autonomous agents, each holding a globally routable IPv6 /128 from 2a04:2a01::/32 announced by AS219419. One command shell reads the whole fleet, and one document decides which member may reach which.

bash
whisper whale status

That prints this node's identity and connection, then every peer in the fleet. Without a key the node half still answers.

Every member is minted through the control plane rather than configured on the machine, and what it is called follows from the address it draws. That derivation, the short label you can set beside it, and the tags a grant later matches on are covered in nodes, names and tags.

Reading comes before writing. Inspect your fleet covers the status screen, a measured round trip to one peer, and the keyless lookup that says who holds any address on the internet. Whalenet DNS records covers the resolver profile in effect on a host and the records your fleet publishes in its own subtree.

Governing is one file. The access document is its grammar, its grants and the tests block that has to pass before a write lands. East-west reachability is the order in which a connection between two of your own members is decided, and approval and holds is how a new member is admitted to its siblings, or a live one unbound.

Putting a local port in front of an audience, whether that is the fleet or the internet, is serve and funnel. SSH between nodes opens a shell with the host key proven from the IANA DNSSEC root. Managed settings is what an MDM pins on a machine so the client arrives ready, and plan a migration reads a mesh you already run into a file you can study before anything changes.