MultiTunnel Contact us

Invite and approve

Make an invite, send it to the person, then approve the reply code their device sends back, once its fingerprint matches.

Invite and approve, step by step

Here Sam, who looks after Northwind Clinic, invites Dana and approves her laptop. Use Next, or click what's highlighted.

  1. Invite someone

    Open the network. On an administrator's computer, its page has Administer Northwind Clinic. Choose Invite or approve.

  2. Who, and for how long

    Under Who is it for?, choose the person, or Anyone to have them type their name when they join. Choose how long it works: 1, 8 or 24 hours, and under Where are they?, whether they're On the same Wi-Fi or office network as this computer or Somewhere else. Then choose Make the invite and copy it….

    For someone at home or in another office, choose Somewhere else. Inviting someone somewhere else

    Add someone under People first to invite them by name: their device then joins as them. For a server, gateway, relay or kiosk, choose its service here. Set up a server as a service

  3. Windows asks

    Windows asks for permission. Choose Yes.

  4. Send the invite

    The invite is copied as a link, https://multitunnel.co.uk/join#mt2:…. Paste it into an email or a message to the person, and send it. Opening it fills in MultiTunnel's Join screen on their device, or, if they don't have MultiTunnel yet, shows them how to get it. MultiTunnel clears it from the clipboard after 10 minutes.

    For a phone in the same room, choose Show the QR code instead, and let the phone's camera scan it. Inviting a phone with a QR code

    An invite is a secret until it's used: send it only to the person it's for.

  5. Paste their reply code

    Their device shows a reply code, which they send you. Paste it under Approve a device. The device's name and fingerprint appear.

  6. Check the fingerprint

    Ask the person to read out the fingerprint on their screen. Go on only if it matches. Then choose Approve….

    If your invite didn't name them, type their name first, and tick They're new if they aren't under People yet. A device that joins for a service says so here: unless the invite was for the service, type the service's name.

  7. Go ahead?

    Windows asks for permission. Then MultiTunnel shows the device and its fingerprint again. Check them, and choose Yes.

  8. Your PIN

    Windows asks for your admin PIN, in its own window, so the PIN goes only to Windows.

  9. Approved

    The device joins within a minute, by itself. The person's window says You're in.

Command line

On Windows, in Terminal (Admin), once you have set $mt and $st. On Linux, in a terminal. Before you start

Make an invite for a person, working for 8 hours, as when you leave out -hours (24 is the most). Leave out -for for anyone, and add -at elsewhere for someone somewhere else.

Windows
& $mt invite $st northwind -for dana -hours 8
Linux
sudo multitunnel invite /var/lib/multitunnel northwind -for dana -hours 8

Approve from the reply code. Add their username if the invite didn't name them, and -new-user for someone not yet in the network.

Windows
& $mt approve $st northwind "<paste the reply code here>"
Linux
sudo multitunnel approve /var/lib/multitunnel northwind "<paste the reply code here>"

Or approve by the device's name and fingerprint:

Windows
& $mt approve $st northwind dana-laptop 4c1e-9b27-a03f
Linux
sudo multitunnel approve /var/lib/multitunnel northwind dana-laptop 4c1e-9b27-a03f

Either way, approve shows the device's fingerprint before it asks anything or asks for your PIN: check it matches the one on the device's screen, as in the app.

For a service, invite with -for "service:File server"; a device that joined for a service without such an invite is approved with -service "File server". Set up a server as a service

Inviting a phone with a QR code

An invite is a link, and the phone's camera can read it from your screen. Nothing needs copying onto the phone.

  1. Make the invite as above. Under the steps, choose Show the QR code.
  2. The person points their phone's camera at the code, and opens the link it finds. With MultiTunnel on the phone, it opens at Join a network with the invite filled in. Without it, the link's page says how to get MultiTunnel first.
  3. Choose Hide the QR code once their phone has scanned it. Anyone who can see the code can use the invite, so don't leave it on screen, and don't share a picture of it. When the invite ends, the code goes by itself.
  4. They join on the phone as usual, and send you the reply code it shows. Approve it under Approve a device. Join on an Android phone
  • Opening the link only fills in the invite. The person still reads what joining means and asks to join, and you still approve their phone.
  • The phone says the invite came from a link, and names the network it says it's for, so they ask to join only if they were expecting it from you.
Command line

On Windows, in Terminal (Admin), once you have set $mt and $st. On Linux, in a terminal. Before you start

At a terminal, invite prints the link and, under it, a QR code of the link for a phone's camera. If the window is too small for the code, it says how large to make it: make the window larger and run it again, or use Show the QR code in the app. Piped into another program or a file, it prints the invite alone.

Windows
& $mt invite $st northwind -for dana -hours 1
Linux
sudo multitunnel invite /var/lib/multitunnel northwind -for dana -hours 1

Inviting someone somewhere else

A new device first contacts the computer that made the invite. Someone on the same Wi-Fi or office network reaches it there. For someone at home, or in another office, choose Somewhere else under Where are they? when you make the invite.

  • If this computer can be reached from anywhere

    If it has a public internet address of its own, such as a server, the invite uses that address.

  • Otherwise, your router lets them in for a while

    MultiTunnel asks this computer's router to let their device in, on two ports for this network only, and only while the invite lasts. About a minute after the invite ends, it closes them again. At the command line, it says which ports it opened and until when.

  • Who can reach those ports

    While they're open, anyone on the internet can reach those two ports, but MultiTunnel answers only devices it knows, and stays silent to everything else. If MultiTunnel stops without closing them, such as in a power cut, the router closes them by itself within 2 hours.

When the router won't let them in

Then no invite is made, because their device could never get through. MultiTunnel says why, in plain words:

  • the router didn't answer (it may not offer this, or has it turned off);
  • the router refused;
  • the router opened only one of the two ports it needs;
  • this computer is behind a second router, often the internet provider's own, which can't be asked.

It also says what would work instead. Do one of these:

  1. Make the invite on a device people can reach from anywhere, such as one of the network's servers with a public address, at its command line, then approve the reply code on your computer as usual. If the network has a relay, MultiTunnel names it.
  2. Forward the two ports. Ask whoever looks after this computer's router to forward the two UDP ports MultiTunnel names to this computer. Then make the invite at the command line, with -at and your public address.

If it says the router is still being asked, try again in a moment. Someone on the same Wi-Fi or office network as this computer can always join with an ordinary invite.

Command line

On Windows, in Terminal (Admin), once you have set $mt and $st. On Linux, in a terminal. Before you start

An invite for someone somewhere else:

Windows
& $mt invite $st northwind -for dana -at elsewhere
Linux
sudo multitunnel invite /var/lib/multitunnel northwind -for dana -at elsewhere

If your router already forwards the two ports, give your public address. If it's their computer that can be reached instead, give their public address and an even port from 40000 to 59998 with -to.

Windows
& $mt invite $st northwind -for dana -at 203.0.113.10
Linux
sudo multitunnel invite /var/lib/multitunnel northwind -for dana -at 203.0.113.10
Windows
& $mt invite $st northwind -for dana -to 198.51.100.24:40000
Linux
sudo multitunnel invite /var/lib/multitunnel northwind -for dana -to 198.51.100.24:40000

The addresses here are examples: use your own.

A device coming back

When a device that was a member before joins again, its old access went with its old keys, so it gets only what the rules give its person. To give it what it had, tick Give it the same access as before when you approve it. The window then lists what it gets back before you type your PIN.

Command line

On Windows, in Terminal (Admin), once you have set $mt and $st. On Linux, in a terminal. Before you start

Windows
& $mt approve $st northwind "<paste the reply code here>" -same-access
Linux
sudo multitunnel approve /var/lib/multitunnel northwind "<paste the reply code here>" -same-access

Letting people add their own devices

  1. Open Administer, then Settings, and find Adding devices.
  2. Choose People can add some of their own devices, and how many each person can add.
  3. Choose Save….

From a device you approved, a person can then add a new phone or laptop of their own, without asking you. Each added device ends when the one that added it does. You can still approve more for anyone. Choose Only administrators approve devices to turn it off.

The person adds a device from the command line: they make an invite on their approved device, join with the new one, and approve its reply code on the first.

Command line

On Windows, in Terminal (Admin), once you have set $mt and $st. On Linux, in a terminal. Before you start

For you, as administrator:

Windows
& $mt self-enrol $st northwind on 3
Linux
sudo multitunnel self-enrol /var/lib/multitunnel northwind on 3
Windows
& $mt self-enrol $st northwind off
Linux
sudo multitunnel self-enrol /var/lib/multitunnel northwind off

For the person: on their approved device, make an invite (on Windows, in their own Terminal, not as administrator):

Windows
& $mt invite $st northwind
Linux
sudo multitunnel invite /var/lib/multitunnel northwind

On the new device, join with it, as themselves (on Linux, without sudo):

Windows
& $mt join $st auto dana-phone "<paste the invite here>"
Linux
multitunnel join /var/lib/multitunnel auto dana-phone "<paste the invite here>"

Back on the first device, approve the reply code. On Windows this needs Terminal (Admin), as MultiTunnel's state folder is open only to administrators:

Windows
& $mt approve $st northwind "<paste the reply code here>"
Linux
sudo multitunnel approve /var/lib/multitunnel northwind "<paste the reply code here>"

Letting a device approve for a day

A delegation lets a trusted device approve devices for the people you name, for up to 24 hours, such as during a setup day. It is a paid feature, and is done from the command line.

Command line

On Windows, in Terminal (Admin), once you have set $mt and $st. On Linux, in a terminal. Before you start

Let reception-pc approve up to 10 devices for two people, for 8 hours:

Windows
& $mt delegate $st northwind reception-pc 8 10 dana,lee
Linux
sudo multitunnel delegate /var/lib/multitunnel northwind reception-pc 8 10 dana,lee

End it early:

Windows
& $mt undelegate $st northwind reception-pc
Linux
sudo multitunnel undelegate /var/lib/multitunnel northwind reception-pc

End it, and remove the delegate and every device it added (it shows the list first):

Windows
& $mt revoke-delegate $st northwind reception-pc
Linux
sudo multitunnel revoke-delegate /var/lib/multitunnel northwind reception-pc

Still stuck?

Email us and a person will reply. For a security problem, write to security@multitunnel.co.uk instead.

enquiries@multitunnel.co.uk