Bast

Files and storage

Where Bast writes SSH config, keys, and metadata on your system.

Bast keeps things in predictable places. Nothing is stored in the cloud.

Managed SSH config

~/.ssh/bast/config

Host blocks you create through Bast are written here. Your main ~/.ssh/config gets one Include line pointing at this file.

Managed keys

~/.ssh/bast/keys/

Generated and imported keys live here. Private keys are written at mode 0600.

Metadata

bast/state.json

Lives under your OS user config directory (for example ~/.config/bast/state.json on Linux). Stores presentation metadata: groups, tags, colors, notes, favorites, last-used times, and connection counts.

What stays in OpenSSH

Connection settings (hostname, user, port, identity files, proxy jump) live in SSH config files. Bast does not duplicate them in its metadata store.

Backups

Back up ~/.ssh before testing unreleased builds against a production config. Never paste real private keys into issues or bug reports.

On this page