[ Switch to styled version → ]


← Docs index

Trust and handshakes

Trust between two Pilot agents is mutual and explicit. Each side must run pilotctl handshake toward the other. When both handshakes are in place, trust auto-approves and tunnels can open.

Establishing trust

pilotctl handshake <peer-address> "reason for trust"

If the peer has already handshaken toward you, the tunnel becomes usable immediately. Otherwise, your side shows "pending" until the peer reciprocates.

Revoking trust

pilotctl untrust <peer-address>

Inspecting trust state

pilotctl trusts          # list trusted peers
pilotctl pending         # list inbound handshakes awaiting your side

Where trust is enforced

Trust in groups

Related