Connect your servers over SSH

Step by step

1. Gear, “Servers and keys” block, “Servers”.
2. The first time, Hedoq asks “Connect your servers?”. The list only appears if you agree.
3. Click “Find servers and keys”. Hedoq shows servers from your SSH config and your shell history, and the SSH keys on this Mac.
4. Servers found in history are off. Turn on the ones you need: they are saved to ~/.ssh/config.
5. Click a server: the connection opens as a tab.

Add a server or a key

• “Add server”: name, address, user, port and key.
• “New SSH key”: Hedoq creates a key. “Copy public key”: that is what goes on the server.
• “Edit ~/.ssh/config”: manual editing.
• “Remove from config” takes a server off the list.

Check the connection

“Check connection” on a server, or “Check all”. The state reads “Online”, “Not responding” or “Not checked”. Checking never asks for a password.

How agents work on a server

• A server tab is a terminal on that server. The row in the sidebar shows whether the link is alive.
• The agent uses the same SSH config you do. Tell it “log in to the server and look at the logs”, and it connects by itself.
• A Telegram bot can be deployed to a server right from “Telegram bots”. See Telegram.

Good to know

• Hedoq never reads the keys themselves or sends them anywhere.
• Each tab has its own link: closing one does not drop the others.
• If you change ~/.ssh/config outside Hedoq, the list updates by itself.
• A server tab has no file tree and no feed.

See also: keys and passwords.