Access from anywhere
What you will learn What a tunnel is and how to open one, and what you must check before opening it.
At first it only opens on your machine
Immediately after install the address is:
localhost means this computer. It does not open from another device in the
same house, nor from outside.
Tunnel — creating a fixed address
Connect one from the dashboard's top-right Settings (gear) → General tab → Tunnel card, and you get a fixed address.
graph 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.
Before you open it — the password
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.
Know what is being opened
What the tunnel opens is the entire HyperTeams interface. Someone who connects successfully can:
- see files in your registered working directories
- hand over tasks
- type commands in the terminal
That is substantial authority over that machine. Treat the password accordingly.
Restart after connecting
After connecting a tunnel, it takes a restart to apply.
What opening it enables
Install it on your phone like an app
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.
Notifications when work finishes
You can get a phone notification when work you handed over completes. Set a long job running, go out, get notified.
Sharing results
A dev server started in the terminal opens through that address too. You can send a colleague the link.
Connecting your own domain
If you own a domain, connect it on the same screen. You can use something like
mydomain.com instead of the default address.
Using it safely
| 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.
Common questions
"Is the tunnel paid?"
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.
"Our security policy probably won't allow it"
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.
"Does the tunnel make it slower?"
It routes via the internet, so it is slower than localhost. At the level of
screen interaction the difference is hard to notice.
Check yourself
1. What must you do before opening a tunnel?
Answer
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"?
Answer
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?
Answer
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