What you will learn What a tunnel is and how to open one, and what you must check before opening it.
Immediately after install the address is:
localhost means this computer. It does not open from another device in the
same house, nor from outside.
Connect one from the dashboard's top-right Settings (gear) → General tab → Tunnel card, and you get a fixed address.
HyperTeamsgraph TD
P["Phone · laptop elsewhere"] --> T["Fixed address<br/>the internet"]
T --> H["HyperTeams on your machine"]
H --> F["Working directories"]You do not have to touch your router. Your machine makes the outbound connection, so no port forwarding and no static IP.
The more you open outward, the more the password matters. Set it first.
On localhost, only someone with access to your computer could open it. Open a
tunnel and anyone who knows the address can try.
Set a solid password before you open the tunnel.
What the tunnel opens is the entire HyperTeams interface. Someone who connects successfully can:
That is substantial authority over that machine. Treat the password accordingly.
After connecting a tunnel, it takes a restart to apply.
Open the address in your phone's browser and add to home screen to use it like an app. It is built for small screens, so phone use is not an afterthought.
You can get a phone notification when work you handed over completes. Set a long job running, go out, get notified.
A dev server started in the terminal opens through that address too. You can send a colleague the link.
If you own a domain, connect it on the same screen. You can use something like
mydomain.com instead of the default address.
| Check | Why |
|---|---|
| Is the password strong enough | it is the only door |
| Are working directories drawn narrowly | that is what a visitor can see |
| Do you close the tunnel when unused | close it if there is no reason to keep it open |
| Did you paste the address somewhere careless | chat rooms and issues keep it |
The second matters. If you drew a working directory as your whole home folder, opening a tunnel makes all of that the exposed surface.
In Connect's system registration the tunnel is a paid add-on (see connecting a system). Check HyperTeams' own tunnel policy on the settings screen.
It creates an outbound channel, so it may fall foul of policy. Using it purely
on localhost is a completely normal way to use it. The tunnel is optional.
It routes via the internet, so it is slower than localhost. At the level of
screen interaction the difference is hard to notice.
1. What must you do before opening a tunnel?
Set a solid password. On localhost only someone with access to your machine
could open it; with a tunnel, anyone who knows the address can try, and the
password is the only door.
2. Why is what the tunnel opens "substantial authority"?
Because a successful connection allows viewing working directory files, handing over tasks, and running terminal commands. That is broad authority over the machine.
3. What do working directories have to do with the tunnel?
The working directory is the exposed surface. If you registered your home folder, opening the tunnel puts your personal files inside what a visitor can see.
The commands, collected → Command reference
http://localhost:27777hyperteams setuphyperteams restart