Install TYO Reach on Linux

The recommended way to install on Linux is from our APT or RPM repository — it's GPG-signed and updates arrive with your normal system update, no manual re-download each release. Packages are amd64 / x86-64 only for now.

Quickest: one-line installer

Run it with sudo and it detects your package manager (apt, dnf or yum), adds the repository and installs the package, so updates arrive with your normal system update:

curl -fsSL https://reach.tyo.com.au/install.sh | sudo sh

Run it without sudo and it installs the binary to ~/.tyoreach/bin instead, adds a desktop entry and autostart, and puts it on your PATH — handy on a machine where you can't add repositories.

Prefer to see exactly what's being added? Use the per-distro steps below — they do the same thing by hand, with the signing key pinned explicitly.

Debian / Ubuntu / Mint (APT)

curl -fsSL https://reach.tyo.com.au/repo/apt/tyoreach.gpg | sudo tee /usr/share/keyrings/tyoreach.gpg >/dev/null
echo "deb [signed-by=/usr/share/keyrings/tyoreach.gpg] https://reach.tyo.com.au/repo/apt stable main" | sudo tee /etc/apt/sources.list.d/tyoreach.list
sudo apt update && sudo apt install tyoreach

Updates arrive automatically with sudo apt upgrade.

Fedora / RHEL / Rocky / Alma (DNF)

sudo dnf config-manager --add-repo https://reach.tyo.com.au/repo/rpm/tyoreach.repo
sudo dnf install tyoreach

Updates arrive automatically with sudo dnf upgrade.

openSUSE (zypper)

openSUSE uses the same RPM repository:

sudo zypper addrepo https://reach.tyo.com.au/repo/rpm tyoreach
sudo zypper --gpg-auto-import-keys refresh
sudo zypper install tyoreach

Manual download (any distro, no repo)

Grab the current .deb or .rpm directly from the download page and install it with your package manager, e.g. sudo apt install ./tyoreach-<version>-amd64.deb or sudo dnf install ./tyoreach-<version>-amd64.rpm. Prefer the repo method above where you can — it keeps TYO Reach updated automatically.

First run

Launch TYO Reach from your app menu (or run tyoreach). It sits in the system tray: click it, choose Sign in to TYO Reach, confirm in the browser, then click Enable All. The menu shows Proxy: ON and your gateway region.

The tray icon works on most desktops (KDE, XFCE, Cinnamon and others that support StatusNotifierItem). On GNOME you may need the AppIndicator extension for the icon to appear.

Headless servers and the CLI

No desktop? The same package includes the command-line client. On a server you can host persistent terminal sessions with reach host and attach from any of your devices, or drive the proxy from the shell — see Reach Sessions and the CLI reference.

Common questions

Which architectures are supported?

Linux packages currently cover amd64 / x86-64 only.

How do I update?

If you installed from the repository, sudo apt upgrade or sudo dnf upgrade picks up new releases like any other package. Manual .deb/.rpm installs need a fresh download from the download page.

How do I remove it?

sudo apt remove tyoreach or sudo dnf remove tyoreach. Remove the repo file under /etc/apt/sources.list.d/ or /etc/yum.repos.d/ if you no longer want updates offered.

Other platforms

Windows · macOS · Android · iPhone and iPad · All platforms