Quick start

Connect to your first server in under two minutes with Bayesian SSH.

From zero to connected

1. Save a host

   Add a connection entry to the local database with bssh add. Provide a friendly name and the target hostname or IP address:

   bssh add web-prod web-prod.example.com -u deploy --tags prod,web

   You can optionally specify a port (-p 2222), an SSH key (-i ~/.ssh/id_ed25519), or a jump host (-b bastion.example.com).

2. Connect using fuzzy search

   Connect to your saved host with bssh connect:

   bssh connect prod

   You do not need the full or exact name. bssh matches parts of names, aliases, hostnames, and tags. Separators are ignored, so webprod matches web-prod. When multiple hosts match, Bayesian ranking places the host you use most often or most recently at the top.

3. Import your SSH configuration

   If you already have hosts defined in your OpenSSH configuration, import them into Bayesian SSH:

   bssh import

   bssh import reads ~/.ssh/config by default. It parses Host, HostName, User, Port, and IdentityFile directives, skipping Match blocks, and creates saved connections automatically.

4. Open the desktop app

   Launch the graphical interface in the background:

   bssh desktop

   The desktop app shares the same local database as the CLI. You can browse hosts, filter by tags, open embedded terminal tabs, transfer files, and open the command palette with Ctrl+K.

Next steps

Managing connectionsEdit, duplicate, remove, and tag connections.

Search and rankingHow fuzzy search and Bayesian ranking pick the right host.

First-time configurationSet default usernames, ports, and bastions.

bssh TeamsShare connections with your team using end-to-end encryption.