Connections
Managing Connections
Add, edit, and delete SSH connections from the Connections page.
The Connections page (formerly "Hosts") lets you manage your SSH connections.
Adding a connection
- In Connections, click New Connection or press
Cmd+N/Ctrl+N. - The Add Connection dialog opens. Choose the Connection Type:
| Type | Use case | Required fields |
|---|---|---|
| SSH | Remote servers, Linux/Unix hosts | Host, Port, Username, Auth method |
| S3 | AWS, MinIO, Cloudflare R2 | Endpoint, Region, Bucket, Access Key, Secret Key |
| FTP | Standard FTP servers | Host, Port, Username, Password |
SSH connections
| Field | Required | Description |
|---|---|---|
| Name | Yes | Friendly display name shown on the card |
| Host | Yes | IP address or hostname |
| Port | Yes | Default 22 |
| Username | Yes | SSH login username |
| Group | No | Parent group for organizing |
| Auth method | Yes | Password / SSH Key |
| Password / Key | Depends | Credentials stored in the vault |
- Click Save.
Editing a connection
- Right-click the card → Edit, or
- Click the
…button on the card → Edit.
The Edit Connection dialog is identical to the Add dialog. All changes are saved to config.yaml immediately.
Deleting a connection
Right-click the card → Delete. A confirmation dialog appears before the connection is removed. This action cannot be undone.
Connecting
| Connection type | How to connect |
|---|---|
| SSH | Double-click the card to open an SSH terminal tab. |
| S3 / FTP | Double-click the card to open a File Transfer tab directly. |
Single-click selects any card (teal ring) without connecting.
Each connection opens in its own tab. Ternux supports multiple simultaneous SSH sessions.
Quick Connect
Press Cmd+K / Ctrl+K to open the Spotlight palette and type the connection name. This lets you connect without navigating the Connections tab.