> ## Documentation Index
> Fetch the complete documentation index at: https://sen-f208ff9e.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Add your first host, connect, run a command and open SFTP in a few minutes.

This walkthrough uses a demo host. Replace `demo`, `127.0.0.1` and port `2222` with your own server. You need [YourSSH installed](https://sen-f208ff9e.mintlify.site/installation.md) 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](https://mintcdn.com/sen-f208ff9e/KwGOqbG40_L2ILah/images/02-add-host/01-new-host-panel.png?fit=max\&auto=format\&n=KwGOqbG40_L2ILah\&q=85\&s=59f28b05482ca13c63f02b796265eff3)

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](https://sen-f208ff9e.mintlify.site/user-guide/hosts.md) for every option.

![The host editor filled with the label Demo Server, host 127.0.0.1, port 2222 and user demo](https://mintcdn.com/sen-f208ff9e/KwGOqbG40_L2ILah/images/02-add-host/09-filled-form.png?fit=max\&auto=format\&n=KwGOqbG40_L2ILah\&q=85\&s=ce4639464c9cb9ee69e44463918aa57e)

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](https://mintcdn.com/sen-f208ff9e/KwGOqbG40_L2ILah/images/02-add-host/11-dashboard-with-host.png?fit=max\&auto=format\&n=KwGOqbG40_L2ILah\&q=85\&s=2080a0378f97a35aa8dd990b84a8556d)

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](https://sen-f208ff9e.mintlify.site/user-guide/host-keys.md) for what that means and when you get a warning.

![A host card with the test, SFTP and more-actions buttons visible on hover](https://mintcdn.com/sen-f208ff9e/KwGOqbG40_L2ILah/images/03-first-connect/02-card-hover-actions.png?fit=max\&auto=format\&n=KwGOqbG40_L2ILah\&q=85\&s=39a9746880e7c59609e25e5be0b827d7)

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](https://mintcdn.com/sen-f208ff9e/KwGOqbG40_L2ILah/images/03-first-connect/07-terminal-ls.png?fit=max\&auto=format\&n=KwGOqbG40_L2ILah\&q=85\&s=1bacfefc08e081a8a162e1c671d5905b)

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](https://mintcdn.com/sen-f208ff9e/KwGOqbG40_L2ILah/images/07-sftp/03-dual-panel.png?fit=max\&auto=format\&n=KwGOqbG40_L2ILah\&q=85\&s=ffe25b0de5d7cdebbbd8923b0b22913f)

Dual-panel SFTP.

## Next steps

> [card] [Hosts](https://sen-f208ff9e.mintlify.site/user-guide/hosts.md)
>
> Groups, tags, keys, jump hosts and per-host options.

> [card] [Terminal](https://sen-f208ff9e.mintlify.site/user-guide/terminal.md)
>
> Tabs, split view, search and hotkeys.

> [card] [SFTP](https://sen-f208ff9e.mintlify.site/user-guide/sftp.md)
>
> Transfer files in both directions.

> [card] [Keychain](https://sen-f208ff9e.mintlify.site/user-guide/keychain.md)
>
> Generate an SSH key and deploy it to a host.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.