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>.
| System | Processor | File |
|---|---|---|
| macOS | Apple Silicon (M1 and later) | …-arm64.dmg, or the .zip |
| macOS | Intel | …-x64.dmg, or the .zip |
| Windows | x64 | …-x64.exe installer |
| Windows | Arm64 | …-arm64.exe installer |
| Linux | x64 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
- Open the
.dmgand drag Gatesys SSH into Applications. (With the.zip, unzip it and move Gatesys SSH.app into Applications.) - 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
- Run the installer for your processor, for example
Gatesys-SSH-<version>-x64.exe. - If Windows protected your PC appears, click More info, then Run anyway.
- Follow the installer. It installs for your user account, and you can change the install folder.
- 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.AppImageUse 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-*.debFedora, RHEL and openSUSE
Install the .rpm with your package manager, for example on Fedora:
sudo dnf install ./Gatesys-SSH-*.rpmOn 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
Something unclear or wrong? Tell us.