Prerequisites
- Your Breeze IP address (found in the portal dashboard)
- Your root password (set during deployment) or an SSH key
- An SSH client (built into macOS/Linux, use PuTTY on Windows)
Connect from macOS or Linux
ssh root@YOUR_IPIf using a custom SSH key:
ssh -i ~/.ssh/your_key root@YOUR_IPConnect from Windows
Using PowerShell (Windows 10+)
ssh root@YOUR_IPUsing PuTTY
- Download PuTTY from the official website
- Enter your Breeze IP in the Host Name field
- Port: 22
- Connection type: SSH
- Click Open
- Login as: root
- Enter your password
First-Time Connection
On your first connection, you will see a fingerprint warning:
The authenticity of host '198.48.63.241' can't be established.
ED25519 key fingerprint is SHA256:xxxx...
Are you sure you want to continue connecting? yesType yes to add the server to your known hosts.
First Steps After Login
- Update the system:
apt update && apt upgrade -y - Set the timezone:
timedatectl set-timezone America/Chicago - Create a non-root user:
adduser deploy && usermod -aG sudo deploy
Troubleshooting
| Problem | Solution |
|---|---|
| Connection refused | Breeze may still be provisioning — wait a few minutes |
| Permission denied | Check your password or SSH key |
| Connection timed out | Verify the IP address in your dashboard |