UpaRemote SSH

What it does

• Open real terminal sessions on your Mac, Linux machine or Windows (WSL) from your iPhone, Android phone, or another computer's shell.
• Several terminals as tabs; sessions keep running on the computer when you leave the app.
• Keyboard bar with Esc, Ctrl, Alt, Tab, arrows and common shortcuts.
• Your computer connects out to our relay, so it works behind any router or firewall.

Getting started

1. Create an account in the app (we email you a confirmation code).
2. Tap + to add a computer and pick macOS, Linux or Windows.
3. Run the one-line install command the app shows, on that computer. It pairs the computer with your account:

   curl -fsSL https://remote.upanet.org/install.sh | sh -s -- ABCD-2345

4. Tap the computer in the app to open a terminal.

The agent runs in the background and starts with your computer (launchd on macOS, a systemd user service on Linux, a startup script on Windows/WSL).

Update the agent: curl -fsSL https://remote.upanet.org/install.sh | sh
Remove it: curl -fsSL https://remote.upanet.org/install.sh | sh -s -- --uninstall

Command-line client (upa)

Open terminals on your computers from any macOS or Linux shell (including WSL), using the same account as the app. Install it:

curl -fsSL https://remote.upanet.org/install.sh | sh -s -- --client

This puts upa in ~/.local/bin — add that folder to your PATH if the installer says so. Run the same command again to update it.

Then:

upa login                  # your app email + password
upa ls                     # numbered list of computers and open terminals
upa connect 1              # new terminal on computer 1 (number, ID or part of the name)
upa connect 1 8c03e845     # reattach to a running terminal
upa close 1 8c03e845       # end a terminal
upa logout

In a terminal, press Enter then ~. to detach — the shell keeps running and you can reattach later from upa or the app. Type ~~ to send a literal ~. Piped input works too: echo uptime | upa connect 1.

To remove it, delete ~/.local/bin/upa and ~/.config/remotemac/client.json.

Account

Delete your account in the app under Account → Delete Account. See the privacy policy.

Support

Questions or problems: info@upanet.org. We usually reply within 2 working days.