Documentation
Get connected
From a fresh install to your first terminal in four steps. Nothing leaves your machine along the way.
Looking to bring servers over from another client? See Import your servers.
Install Termiyo
Take the build for your computer
From the download page: the Universal .dmg on a Mac, the installer on Windows, and your distribution’s package — .deb, .rpm or AppImage — on Linux, with an arm64 build where it applies. The download page shows how to verify what you downloaded and how to install it on each system.
Create your vault
Choose a master password
The first time you open Termiyo it asks for a master password. This is the only thing protecting everything the app stores. It is never sent anywhere, and there is no recovery — use a passphrase of several unrelated words, not a password you might forget.
What the vault holds
Every host, identity, key and snippet lives in the vault, encrypted at rest. Termiyo locks the vault when you leave it idle and reopens it with the same password; the password itself is never stored.
Add an identity
A login you reuse
An identity is a username plus how to authenticate: a password, a private key, or an agent. Identities are separate from hosts so the same login works across a whole fleet without being retyped on every machine.
Leave the password empty to use a key
With no password set, the login tries the SSH key you chose, then the keys in your SSH agent (ssh-agent, 1Password, Pageant), and only asks for a password if the server prompts for one.
Add a host and connect
Add the host
Give it an address and pick an identity. Double-click it to connect. You can group hosts, tag them and filter the list once you have more than a handful.
The first connection pins the key
The first connection shows the server’s key fingerprint. Accepting it pins the key, and every reconnect after is checked against it — if the server’s key ever changes, Termiyo stops and tells you rather than connecting anyway.
A local shell too
You do not need a server to open a terminal. A local shell tab runs the shell on this computer, with the same tabs, splits and snippets as a remote session.