SSH
Save your servers and connect in a pane — login is handled by your system OpenSSH; secrets are never stored.
DiceTerm treats SSH as a first-class pane. You save a server once and open it with a click — no credentials ever touch DiceTerm's storage.
Adding a server
Open the server panel and click Add server. Fill in four fields:
| Field | Notes |
|---|---|
| Label | A friendly name shown in the sidebar |
| Host | Hostname or IP address |
| User | The remote username |
| Port | Default 22; change only if needed |
That's the entire record. DiceTerm stores host, user, and port — nothing else.
Authentication
DiceTerm never stores passwords or private keys. Authentication is delegated entirely to the Windows OpenSSH client. That means your existing ~/.ssh/config, key files, and agents all work without any extra configuration:
- If you have a key loaded (via
ssh-agentor listed in~/.ssh/config), the connection opens silently. - If no key is found, OpenSSH prompts for a password in the pane itself — the same prompt you'd see in a plain terminal.
DiceTerm calls ssh.exe -p <port> user@host and leaves auth entirely to OpenSSH. Host and user values are validated before the call to prevent option injection.
Connecting
Two ways to open a connection:
- Click a saved server in the server panel — opens in a new pane.
- Right-click any pane and choose SSH here — spawns the connection in that pane.
Requirements
SSH features require the Windows built-in OpenSSH client. If it isn't installed:
- Open Settings → Apps → Optional Features.
- Search for OpenSSH Client and install it.
DiceTerm looks for ssh.exe on your PATH, falling back to C:\Windows\System32\OpenSSH\ssh.exe.
Session restore
When DiceTerm relaunches after a quit or crash, SSH panes reopen with their scrollback intact and display a ──session restored · reconnecting── banner while the connection re-establishes.
Tips
Tip: Put a
Hostblock in~/.ssh/configwithIdentityFile,User, and anyProxyJumpsettings. DiceTerm picks it all up automatically — the saved server entry just supplies the label and port.
See also
- tmux — drive remote tmux sessions as native local panes