Connections
Managing Connections
Add, edit, and delete SSH or S3 connections from the Connections page.
The Connections page (formerly "Hosts") lets you manage SSH connections and S3-compatible object storage connections side by side.
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 | S3-compatible object storage | API URL, Access Key |
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 |
S3 connections
| Field | Required | Description |
|---|---|---|
| Name | Yes | Friendly display name shown on the card |
| API URL (Endpoint) | Yes | S3-compatible endpoint, e.g. https://s3.amazonaws.com |
| Region | No | AWS or custom region |
| Bucket | No | Leave blank to browse all buckets first |
| Access Key | Yes | S3 access key ID |
| Secret Key | No | S3 secret access key (stored in vault) |
| Group | No | Parent group for organizing |
- S3 connections only — click Test Connection to verify credentials before saving.
- 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. Single-click selects the card (teal ring) without connecting. |
| S3 | Double-click the card to open the S3 file browser. Right-click → Browse S3 also works. |
Each connection opens in its own tab. Ternux supports multiple simultaneous SSH sessions and S3 browsers.
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.