Skip to main content

Four steps to your first connection

1. Install

On both machines:

2. Log in

vpncli uses your Monolex identity — the same login as the rest of the estate. No ssh keys, no per-machine accounts.
Do this on both machines, signed in as the same identity.

3. Host the machine you want to reach

On the target machine (the one you want to connect to), make it reachable:
service install keeps the machine online automatically. Now it advertises itself so your other machines can find it.

4. Connect

From your other machine:
That’s it — you’re on the remote machine, over an encrypted peer-to-peer link.

Check reachability

If a machine shows [stale], on that machine run:

Next

Commands

shell, exec, mosh, tunnel — with examples.

Security

What “encrypted end to end” actually means here.