Skip to main content
This walkthrough uses a demo host. Replace demo, 127.0.0.1 and port 2222 with your own server. You need YourSSH installed and an SSH server you can sign in to.
1

Open the host editor

On the Hosts dashboard, click New host. The host editor opens on the right. Keep SSH selected at the top.
The New Host panel with SSH, RDP and VNC tabs, general and credentials fields

The host editor, empty.

2

Fill in the host

Enter a Label (a name you will recognize), the Hostname or IP, the port (default 22), your Username and Password. To use a key or your SSH agent instead, change Auth method. See Hosts for every option.
The host editor filled with the label Demo Server, host 127.0.0.1, port 2222 and user demo

A filled-in host.

3

Test, then save

Click Test to check the address and credentials without opening a shell. A result such as Connected with a latency appears next to the button. Click Save. The host appears on the dashboard.
The hosts dashboard with the new Demo Server card inside the DEMO group

The saved host on the dashboard.

4

Connect

Double-click the host card to open a terminal tab (or open its three-dot menu and choose Connect). The first time you connect, YourSSH pins the server’s host key. See Host keys for what that means and when you get a warning.
A host card with the test, SFTP and more-actions buttons visible on hover

Hover a card for quick actions: test, SFTP and the full menu.

5

Run a command

When the shell prompt appears, type a command and press Enter.
A terminal tab connected to Demo Server, showing the output of ls -la

A connected terminal after running ls -la.

6

Open SFTP

Click the folder icon on the host card, or open the card’s menu and choose SFTP. The dual-panel file manager shows your computer on the left and the server on the right.
The SFTP screen with the local home folder on the left and the remote home folder on the right

Dual-panel SFTP.

Next steps

Hosts

Groups, tags, keys, jump hosts and per-host options.

Terminal

Tabs, split view, search and hotkeys.

SFTP

Transfer files in both directions.

Keychain

Generate an SSH key and deploy it to a host.