Getting started

sshbar lives in the menu bar, the strip of small icons at the top-right of your screen. Click its icon and a small panel opens. That panel is the whole app: no windows, no Dock icon, no settings maze. Haven't installed it yet? Start at the download page.

0.1 - THE PANEL

Three sections, one search box

The panel has three sections (Servers, Tunnels, and SSH Keys) and a search box that filters all three at once.

sshbar
↻ ⚙︎
Search
Servers
prod-web
203.0.113.5
gateway
198.51.100.12
Tunnels
+
staging postgres via gateway
5432 → db.internal:5432
SSH Keys
+
personal
›
SEARCH Filters Servers, Tunnels, and SSH Keys at the same time.
SERVERS Click one to open an SSH session in your terminal.
TUNNELS Flip the switch to start one; the dot shows its status.
SSH KEYS Expand a key to copy it to the clipboard.
↻ RELOAD Re-reads your ~/.ssh/config after you've edited it.

That's the whole app.

0.2 - OPENING IT

Mouse or keyboard

Click the sshbar icon in the menu bar, or press the global shortcut from anywhere:

⌃ ⌥ S

Once the panel is open, arrow keys move through it and Enter activates: connect to a server, toggle a tunnel, or copy a key, all without touching the mouse. Type to search first if the list is long.

0.3 - USING IT

Click, flip, copy

Connect

Click a server and an SSH session opens in your terminal (Ghostty, iTerm2, Warp, kitty, Alacritty, or Terminal, auto-detected). Recent connections gather at the top of the list.

Tunnel

Flip a tunnel's switch to start it in the background. It keeps running with the panel closed, and stops cleanly when you flip it off or quit.

Copy a key

Expand a key in the SSH Keys section and click copy. Usually that's the public key, the one you paste onto servers.

Reload

Edited your ~/.ssh/config? Hit the reload button (↻) and the server list updates.

sshbar, a free macOS menu-bar app for SSH
Manual Download hello@sshbar.app