Join a network
You need an invite from the network's administrator. Paste it in, send back the reply code your computer shows, and once they approve you, you're connected.
What you need
An invite from the network's administrator. They send it as a message or an email: a link starting https://multitunnel.co.uk/join#, or a long piece of text starting mt2:. It works for a limited time, a day at most.
With a link, open it and choose Open in MultiTunnel: the Join a network screen opens with the invite filled in, and you go on from there. If MultiTunnel isn't on your computer yet, ask the person who sent the invite for the setup. Opening an invite never joins by itself.
An invite is a secret until it's used. Don't pass it on. If you sent it to someone by mistake, ask your administrator for a new one.
Join, step by step
The picture shows each step. Go through it with Next, or click what's highlighted.
Open MultiTunnel
Click the two linked rings by the clock. The MultiTunnel window opens. (You may need to click the small arrow, ^, to see the rings.)
Choose Join a network
In the window, choose Join a network.
Paste the invite
Copy the whole invite from the message or email, and paste it into Invite (Ctrl+V).
This computer's name
Use this computer's name is ticked: in the network, your computer is called by its own name, in small letters, such as
dana-laptop, and if the computer is renamed, its name in the network changes too. Untick it to type a name of your own. Other people in the network see it.Your name in the network
If you're asked for Your name in the network, type it as your administrator knows you. An invite made for you by name doesn't ask: it says the invite is for you, and you join as yourself.
The network is yours on this computer, so leave This computer runs a service unticked: that is for servers and kiosks, which an administrator sets up. Servers and kiosks
Agree, and ask to join
Read What joining means, tick I have read this and agree, and choose Ask to join.
Send the reply code
MultiTunnel asks to join and shows a reply code. Choose Copy reply code, and send it to your administrator by message or email.
Wait for approval
The window says it's waiting for your administrator. They may ask you to read out the fingerprint on your screen: it proves the reply code came from you.
You can close the window now. MultiTunnel keeps asking by itself.
You're in
Once your administrator approves your computer, it connects by itself, usually within a minute. The window says You're in, and the rings by the clock turn to full colour.
Connected
The network's page says Connected, and how many of its other devices you can reach now. Devices that are switched off show as not reachable.
There is nothing else to choose. Your computer takes the network's short name, which its administrator chose. In the rare case that it can't (another network here uses it, or did until lately, or it is a name your computer keeps for itself), MultiTunnel picks a similar one, such as northwind-2, and says why once, under the reply code. Nothing else changes. If you leave a network and join it again, it gets its own short name back. Short name on this computer
Command line
On Windows, in your own Terminal, as yourself (not as administrator), once you have set $mt and $st. On Linux, in a terminal. Before you start
Ask to join, as yourself: on Windows not as administrator, and on Linux without sudo. It shows the fingerprint and a reply code: send the reply code to your administrator. auto takes the network's own short name; give a short name of your own instead only if you need one. Give this computer's own name, as the command's usage shows it, and its name in the network follows the computer's; give another name to choose your own. Then give your name in the network, or leave it out if the invite was made for you.
& $mt join $st auto dana-laptop dana "<paste the invite here>"multitunnel join /var/lib/multitunnel auto dana-laptop dana "<paste the invite here>"Join on an Android phone
The phone app joins the same way, in the same words, with "this phone" for "this computer".
- Open the invite link you were sent, or, if your administrator shows you a QR code, scan it with the phone's camera and open the link it finds. MultiTunnel opens at Join a network with your invite filled in, and says it came from a link: ask to join only if you were expecting an invite to that network from someone you know.
- Or open MultiTunnel, choose Join a network, copy the invite from the message or email, and choose Paste invite.
- Use this phone's name is on: in the network, the phone is called by the name it has in Android's settings, in small letters, such as
galaxy-s24, and follows it if you rename the phone. Turn it off to type a name of your own. - Type Your name as your administrator knows you, or leave it empty if the invite was made out to you.
- Read what joining means, tick I have read this and agree, and choose Ask to join. The first time, Android asks you to allow MultiTunnel's VPN.
- Send the reply code to your administrator with Copy reply code or Share reply code. Once they approve the phone, it connects by itself.
If another invite link opens while you're joining with one, the phone asks Another invite came from a link. Use it instead?: choose Keep this one unless you meant to switch. As on a computer, there is no short name to choose. If another device in the network already has the phone's name, such as a second phone of the same model, the phone is called galaxy-s24-2 instead.
The fingerprint
The fingerprint is a short code that identifies your computer, such as 4c1e-9b27-a03f. Your administrator sees the same code when they paste your reply code, and approves only if the two match. That way they know they're letting in your computer, and nobody else's.
If they ask, read it out to them: on a call, or in person. The fingerprint isn't a secret. Your invite is, until it's used.
Where to be when you join
Join while your computer can reach the computer that made your invite. Your administrator makes an invite either for someone on the same Wi-Fi or office network as their computer, or for someone somewhere else. After joining, you can connect from anywhere.
If joining doesn't move past Asking to join, tell your administrator where you are: they may need to make an invite for someone somewhere else.
Join another network
Join each network the same way, with its own invite. Each one gets its own row in the window and its own switch, and they can all be on at once.
Your name and email are per network: you can be known as one name in one network and another elsewhere. No network can see which other networks your computer is in.
Still stuck?
Ask your network's administrator first: they can see your network and fix most things. For anything they can't, email us. A person will reply.