Adding Hosts
Hosts are the servers you connect to via SSH. To add a host:
- Navigate to the Hosts section in the sidebar
- Click Add Host in the header
- Fill in the host details
- Click Create
Host Fields
- Label — A display name for the host
- Hostname/IP — The server's address (IP or domain)
- Port — SSH port number (default: 22)
- Username — SSH login username. Prefer individual Linux/macOS/Windows accounts or scoped service users over direct root login.
- Auth Type — Use managed SSH keys by default, with encrypted password authentication when required by policy.
- Password — Server password for environments that still require password authentication. Do not send plaintext passwords to teammates.
- SSH Key — Select a managed SSH key that is approved for this host
- Group — Optionally organize hosts into groups
- Color — Assign a color for visual identification
Connect Prompt
If you add a host without authentication material, SSH Bridge will prompt you when you try to connect. You can choose to save the material in the encrypted vault so it can be used for future authorized sessions.
macOS Hosts
macOS already includes an SSH server. You just need to enable it.
Enable SSH on macOS
GUI:
- Open System Settings
- Go to General → Sharing → Remote Login
- Enable Remote Login
You'll see a message like:
To log in remotely:
ssh [email protected]
Enable via Terminal
sudo systemsetup -setremotelogin on
Check the status:
sudo systemsetup -getremotelogin
Expected output:
Remote Login: On
Find Username
whoami
Example:
sergey
Find IP Address
ipconfig getifaddr en0
Wi-Fi example:
192.168.1.100
Connect
From another machine:
ssh [email protected]
Windows Hosts
If you want SSH terminal access to a Windows machine, OpenSSH Server must be installed and running on that machine. You do not need to run these commands every time; they are a one-time setup per Windows host.
Run the following commands in PowerShell as Administrator:
Add-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0
Start-Service sshd
Set-Service -Name sshd -StartupType Automatic
On newer Windows versions, the required Windows Firewall rule is usually created automatically when OpenSSH Server is installed.
Check SSH Server Status
Now check status:
Get-Service sshd
Expected output:
Status Name
------ ----
Running sshd
Check Port 22
netstat -ano | findstr :22
Expected output:
TCP 0.0.0.0:22 LISTENING
Or:
TCP [::]:22 LISTENING
Check SSH Config
Get-Content C:\ProgramData\ssh\sshd_config
Look for:
PasswordAuthentication
PubkeyAuthentication
Test Locally
From the same machine:
ssh localhost
If Windows asks:
Are you sure you want to continue connecting?
Type:
yes
Find Your Username
whoami
Example:
DESKTOP-PC\sergey
Then from another machine:
ssh steven@WINDOWS_IP