Host management
Add, edit, favorite, hide, and organize SSH hosts with groups, tags, and colors.
Press a to add a host or e to edit the selected one. Bast walks you through a form for every connection and metadata field.
Connection fields
| Field | Purpose |
|---|---|
| Label | Display name shown in the list (spaces become SSH-safe aliases) |
| Hostname | Server hostname or IP address |
| User | Remote username (blank uses your SSH default) |
| Port | Port number (blank defaults to 22) |
| Identity | Key file, password auth, or ssh-agent defaults |
| Proxy jump | Route the connection through a jump host |
| SSH flags | Extra OpenSSH options, separated by semicolons or newlines |
Metadata fields
Groups use slash paths like Work/Production. You can nest up to five levels. Press Space on a group header to collapse or expand it.
Tags are comma-separated labels included in search.
Environment is a free-form field (for example production or staging).
Color tints the label in the list so you can spot servers at a glance. Use a hex value.
Notes are short text included in the detail panel and search results.
Actions
| Key | Action |
|---|---|
f | Favorite the selected host |
h | Hide a host you rarely need |
. | Toggle whether hidden hosts appear in the list |
d | Delete a Bast-managed host |
K | Remove a host from your known-hosts file |
Favoriting and hiding are presentation-only changes stored in Bast metadata. Deleting removes the host block from Bast's managed config.
External hosts
Hosts defined outside Bast's managed config can still be edited for metadata (group, tags, notes, and so on). Bast will not change their connection settings or delete them.
Removing a known-host entry (K) helps when a server fingerprint changes and SSH refuses to connect.