Getting Started
Quick Start
Get up and running with your first SSH or S3 connection in under two minutes.
This guide walks you through connecting to your first SSH server from the moment you open Ternux.
Step 1 — Add a connection
- Open Ternux. You land on the Connections tab automatically.
- Click New Connection (top-right of the Connections page) or press
Cmd+N/Ctrl+N. - Choose the Connection Type — SSH or S3.
- For SSH, fill in: Host, Port, Username, and Auth method.
- For S3, fill in: API URL, Access Key, and optionally a Bucket and Secret Key.
- Click Save (or Test Connection first for S3).
Step 2 — Connect
| Type | How to connect |
|---|---|
| SSH | Double-click the card to open a terminal tab. |
| S3 | Double-click the card to open the S3 file browser. |
The first time you connect to an SSH host, Ternux shows a fingerprint verification dialog. Verify the fingerprint matches your server's host key before accepting.
Step 3 — Work
The SSH session opens in a new tab at the top of the window. You can:
- Open more connections — each gets its own tab.
- Switch tabs by clicking or with
Cmd+1–9/Ctrl+1–9. - Close a tab with
Cmd+W/Ctrl+Shift+W(SSH tabs ask for confirmation).