-
Notifications
You must be signed in to change notification settings - Fork 15
User Guide Getting Started
github-actions[bot] edited this page Jun 13, 2026
·
3 revisions
YourSSH is a dark-theme SSH client for macOS, Windows, and Linux. Install it, add a host, and connect in under a minute.
- Download
YourSSH-x.x.x-macOS-universal.dmgfrom the Releases page — one build for both Apple Silicon and Intel Macs. (Releases before 0.1.35 shipped an arm64-only-macOS-arm64.dmg.) - Open the
.dmgand drag YourSSH to/Applications. - First launch only: macOS may block the app because it is not yet notarized. Right-click → Open → Open in the dialog. You only need to do this once.
Alternatively, remove the quarantine flag from Terminal:
xattr -dr com.apple.quarantine /Applications/YourSSH.app- Download
YourSSH.Setup.x.x.x-Windows-x64.exe(orarm64for Surface/Snapdragon). - Run the installer and follow the setup wizard. YourSSH is added to the Start menu.
- Windows SmartScreen may warn on first run. Click More info → Run anyway.
Prefer no installer? Download YourSSH-x.x.x-Windows-<arch>-portable.zip, extract it anywhere, and run yourssh.exe.
# x86_64
sudo dpkg -i yourssh_x.x.x_amd64.deb
# ARM64 (Raspberry Pi 4/5, Apple Silicon Linux)
sudo dpkg -i yourssh_x.x.x_arm64.debRequires Ubuntu 22.04+ / Debian 12+ (glibc ≥ 2.35).
Requires GTK3 (pre-installed on Ubuntu 20.04+, Debian 11+). After install, run yourssh or launch from the application menu.
- Click + (or press Cmd/Ctrl+N) to add a new host.
- Fill in Hostname / IP, Port (default 22), and Username.
- Choose an Auth method: password, private key, certificate, or SSH agent.
- Click Save, then click the host card to connect.
- SSH Connections — organize hosts with groups and tags
- Terminal — learn the keyboard shortcuts
- Settings — set up auto-reconnect and keep-alive