Skip to content

User Guide Getting Started

github-actions[bot] edited this page Jun 13, 2026 · 3 revisions

Getting Started

YourSSH is a dark-theme SSH client for macOS, Windows, and Linux. Install it, add a host, and connect in under a minute.

Installation

macOS

  1. Download YourSSH-x.x.x-macOS-universal.dmg from the Releases page — one build for both Apple Silicon and Intel Macs. (Releases before 0.1.35 shipped an arm64-only -macOS-arm64.dmg.)
  2. Open the .dmg and drag YourSSH to /Applications.
  3. First launch only: macOS may block the app because it is not yet notarized. Right-click → OpenOpen 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

Windows

  1. Download YourSSH.Setup.x.x.x-Windows-x64.exe (or arm64 for Surface/Snapdragon).
  2. Run the installer and follow the setup wizard. YourSSH is added to the Start menu.
  3. 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.

Linux (Debian / Ubuntu)

# 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.deb

Requires 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.

Your First Connection

  1. Click + (or press Cmd/Ctrl+N) to add a new host.
  2. Fill in Hostname / IP, Port (default 22), and Username.
  3. Choose an Auth method: password, private key, certificate, or SSH agent.
  4. Click Save, then click the host card to connect.

What's Next

Clone this wiki locally