Getting started

Install ssher, create an encrypted local vault, save your first server, and connect by name.

1. Install ssher

Windows PowerShell

irm https://getssher.com/install.ps1 | iex

macOS with Homebrew

brew tap johnniewhite/ssher
brew install ssher

Build with Go

go install github.com/johnniewhite/ssher@latest

Confirm the binary is available:

ssher --version

2. Create your vault

Run any vault-backed command, or start with ssher add. On first use, ssher asks you to create a master password. That password derives the key for the encrypted vault and is not sent to ssher Cloud.

◇

Choose a password you can retain.

The local vault has no email reset. Use a password manager and create encrypted backups after setup.

3. Add a server

ssher add

The guided form asks for a name, host, SSH user, port, authentication method, and optional organization fields such as group, tags, notes, or jump host.

Use a memorable, unique name such as production-api. The private key path points to the key on this computer; password authentication is stored inside the encrypted vault.

4. Connect

ssher production-api

You can also connect with ssher connect production-api, a list index, an alias, or a unique fuzzy match. On the first connection, verify the SSH host-key fingerprint before accepting it.

Next steps

Run batch commands and file transfers.
Create groups and profiles in the configuration guide.
Link an encrypted ssher Cloud workspace.
Read the security and privacy model.