Help Center

Everything you need to know about SSH Config Manager

🔍

No articles matched your search. Try different keywords or contact support.

Installation

Installing on macOS

SSH Config Manager ships as a signed but not-yet-notarized DMG. On first launch macOS Gatekeeper will ask you to verify.

  1. Download SSHConfigManager.dmg and open it.
  2. Drag SSH Config Manager into your Applications folder.
  3. Right-click the app in /Applications and choose Open. You will see a warning — click Open in the dialog.
  4. You only need to do this once. Every subsequent launch works normally.

Requires macOS 13 (Ventura) or later on Apple Silicon or Intel.

Editing Config

SSH Config Manager reads and writes ~/.ssh/config. Click + Host in the Config sidebar to create a new entry. Each field (Host, HostName, User, Port, etc.) has its own picker with valid values and inline help.

All edits are written to disk immediately. Your existing config is preserved — comments, formatting, and non-standard options are kept.

The editor exposes 40+ options grouped by purpose (Connection, Authentication, Forwarding, Security, Advanced). Less-common settings like ProxyJump, LocalForward, Match, and CertificateFile are all supported with the same picker UI.

SSH Keys

Switch to the SSH Keys section and click + Key. Choose the algorithm (ED25519 recommended), give the key a filename, and optionally set a passphrase. Public and private files are written to ~/.ssh/ with the correct 600/644 permissions.

Click any key in the list — the public-key block appears with a copy button. Paste it into your server's ~/.ssh/authorized_keys or into a GitHub/GitLab/Gitea key page.

Known Hosts

When a server's host key changes (rebuild, key rotation), SSH refuses to connect. Open Known Hosts, search for the hostname or IP, and click Remove. Hashed entries are handled transparently — you don't need to know the real hostname.

Local Scripts

The Scripts section manages executables in /usr/local/bin/. Create a new script, paste your shell code, and save. The app automatically chmod's it to 755 and makes it available on your $PATH.

Writing to /usr/local/bin/ requires admin privileges. SSH Config Manager prompts for Touch ID first, then falls back to your admin password if Touch ID is unavailable.

Troubleshooting

See Installation above — you need to right-click and choose Open the first time.

Make sure you complete the Touch ID or password prompt when saving a script. If the prompt is dismissed, the write is silently aborted. If Touch ID isn't enrolled on your Mac, SSH Config Manager falls back to osascript with an admin password prompt.

Email info@toz.red with your macOS version, app version, and a description of the issue.