Get started

Install

Download Gatesys SSH for macOS, Windows or Linux, install it, and keep it up to date.

Gatesys SSH runs natively on Apple Silicon and Intel Macs, on x64 and Arm64 Windows, and on x64 and Arm64 Linux. Pick the file for your system, install it, and the app keeps itself up to date from then on.

Choose a download

Download from the download page on gatesys.ai. The files are published as releases of the public gatesys-ai/ssh repository on GitHub, where you can also download them directly, and where the app looks for updates. Files are named Gatesys-SSH-<version>-<arch>.<ext>.

SystemProcessorFile
macOSApple Silicon (M1 and later)…-arm64.dmg, or the .zip
macOSIntel…-x64.dmg, or the .zip
Windowsx64…-x64.exe installer
WindowsArm64…-arm64.exe installer
Linuxx64 or Arm64.AppImage, .deb for Debian and Ubuntu, or .rpm for Fedora, RHEL and openSUSE

Not sure which Mac you have?

Open the Apple menu › About This Mac. A Chip line (Apple M1, M2 and so on) means Apple Silicon; a Processor line naming Intel means Intel.

Signed on macOS, not yet on Windows

The macOS builds are signed with an Apple Developer ID and notarised by Apple. The Windows installer is not code-signed yet, so Windows warns that it cannot verify the publisher; the Windows steps below get you past it. Only install files you downloaded from gatesys.ai or from the gatesys-ai/ssh releases.

macOS

  1. Open the .dmg and drag Gatesys SSH into Applications. (With the .zip, unzip it and move Gatesys SSH.app into Applications.)
  2. Open Gatesys SSH from Applications. The first time, macOS says the app was downloaded from the internet and asks whether to open it. Click Open.

If macOS says it cannot verify the app, or that it “is damaged and can’t be opened”, the download is incomplete or is not one of ours. Delete it and download it again from gatesys.ai.

Windows

  1. Run the installer for your processor, for example Gatesys-SSH-<version>-x64.exe.
  2. If Windows protected your PC appears, click More info, then Run anyway.
  3. Follow the installer. It installs for your user account, and you can change the install folder.
  4. Start Gatesys SSH from the Start menu.

Linux

AppImage

Make the file executable, then run it:

chmod +x Gatesys-SSH-<version>-x86_64.AppImage
./Gatesys-SSH-<version>-x86_64.AppImage

Use the arm64 file on an Arm machine. AppImages need FUSE; if yours does not start, install your distribution’s FUSE 2 package.

Debian and Ubuntu

Install the .deb with apt, which also pulls in its dependencies:

sudo apt install ./Gatesys-SSH-*.deb

Fedora, RHEL and openSUSE

Install the .rpm with your package manager, for example on Fedora:

sudo dnf install ./Gatesys-SSH-*.rpm

On openSUSE, use sudo zypper install ./Gatesys-SSH-*.rpm.

Updates

Installed builds check for a newer version 15 seconds after launch and every six hours after that. The bell in the title bar shows the result. To check straight away, choose File › Check for Updates….

On macOS, Windows and Linux alike, the update downloads in the background. Click Restart to update in the bell, or it installs the next time you restart the app.

A change waiting for Keep holds the restart

While a Safe Change waits for you to keep it, Restart to update waits too and says why: restarting would leave the change to the server’s own restore.

Updates keep your hosts, settings and saved passwords. Secrets are sealed with a key the app owns, not one tied to a particular build, so a new version never asks for them again.

First launch

The first time you open Gatesys SSH, a short setup walks you through your account, the licence, your servers, Farabi and hooks. Every step can be skipped. See First-run setup.

Next

Make your first connection.

Something unclear or wrong? Tell us.