Host Management

Add, edit, tag, and organise all your SSH hosts from one place. Schooner stays in sync with ~/.ssh/config automatically.

Where host data lives

Schooner uses two complementary stores:

• ~/.ssh/config — the source of truth for SSH connection parameters (hostname, user, port, identity file, ProxyJump, etc.). Schooner edits this file with a lossless parser — your comments and formatting are preserved.
• ~/Library/Application Support/Schooner/schooner.sqlite — stores Schooner-specific metadata: nicknames, tags, notes, frecency scores, canvas positions, and connection history. This data never touches your SSH config.

Adding a host

Click the + button in the menubar popover or open the host list window and use the toolbar button. Fill in the connection details and click Save. Schooner writes a Host block to ~/.ssh/config (after creating an automatic snapshot).

Editing a host

Right-click any host → Edit…, or double-click the row. All SSH parameters and Schooner metadata are editable in one sheet.

Tags

Tags are free-form labels stored in Schooner's database (not in ~/.ssh/config). A host can have multiple tags. Use tags to:

• Filter the host list quickly (type a tag name in the search box)
• Colour-code nodes on the ProxyJump canvas automatically
• Trigger the danger-tag confirmation prompt before connecting

Danger tags

Any host tagged prod or production (configurable in Settings → Safety) will show a red border on the canvas and prompt a confirmation dialog before connecting. This prevents accidental connections to production servers.

Nicknames & Notes

A nickname is a human-friendly display name (e.g. "My Home NAS") shown in the popover and TUI in addition to the alias. Notes are freeform text visible when you open the host detail view — great for documenting quirks or credentials hints.

Deleting a host

Right-click → Delete host…. You'll see a confirmation dialog. Deletion removes the Host block from ~/.ssh/config (a snapshot is taken first) and removes all Schooner metadata. This is irreversible from within the app, but you can restore from a backup snapshot.

Searching & filtering

The search box in the popover and the TUI picker both search across alias, nickname, hostname, user, tags, and notes. Frecency sorting ensures your most-used hosts appear first.