Manage Servers
Create a Server Profile
- On Home, open
Addand chooseAdd Server. - Fill host, port, username.
- Choose authentication method (password or private key).
- Save from the server dialog and run a quick connection test.
Manage Keychains in Server Dialog
- In the server dialog, open
Keychainand chooseCreate Keychainto open the keychain editor dialog. - When using inline credentials, click
Save as Keychainto open a prefilled keychain editor dialog. - Save the keychain dialog and Cosmosh will auto-select that keychain for the current server form.
- Use
Edit Credentialsto reopen the selected shared keychain in the same dialog flow.
Default Note Template
- Settings > Advanced > Default Server Note Template pre-fills the Note field when creating a new server profile.
- This template is applied only for new profiles and does not overwrite existing server notes.
Server Address Visibility
- Use Settings > General > Show Full Server Address to control how host/IP values are displayed in server lists.
- Enabled (default): the full server address is shown.
- Disabled: addresses are masked with asterisks to reduce shoulder-surfing risk.
Organize for Daily Use
- Apply stable naming, for example
env-region-role. - Group by environment such as
prod,staging,dev. - Keep high-risk and low-risk hosts visually distinct.
- Move recently changed hosts into a review group for short-term validation.
Tag Behavior Notes
- When viewing a specific folder on Home, tag chips remain visible and only include tags used by that folder.
- Unused custom SSH tags are removed automatically after server/tag updates.
- The reserved
favoritetag is never auto-deleted.
Update or Remove Profiles
- In Home, open the server context menu and choose
Edit. - Update profile fields immediately after host/user/auth changes.
- Re-run a quick test connection after edits.
- Remove stale entries to reduce mistaken connections.
- Double-check before deleting production entries.
Screenshot Placeholders
- Server profile list with environment grouping.
- Edit server dialog with auth fields.
- Delete confirmation for a server entry.