Docs / Getting Started / Connecting to Your Breeze via SSH

Connecting to Your Breeze via SSH

By Admin · Feb 25, 2026 · Updated Apr 23, 2026 · 230 views · 1 min read

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_IP

If using a custom SSH key:

ssh -i ~/.ssh/your_key root@YOUR_IP

Connect from Windows

Using PowerShell (Windows 10+)

ssh root@YOUR_IP

Using PuTTY

  1. Download PuTTY from the official website
  2. Enter your Breeze IP in the Host Name field
  3. Port: 22
  4. Connection type: SSH
  5. Click Open
  6. Login as: root
  7. 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? yes

Type yes to add the server to your known hosts.

First Steps After Login

  1. Update the system: apt update && apt upgrade -y
  2. Set the timezone: timedatectl set-timezone America/Chicago
  3. Create a non-root user: adduser deploy && usermod -aG sudo deploy

Troubleshooting

ProblemSolution
Connection refusedBreeze may still be provisioning — wait a few minutes
Permission deniedCheck your password or SSH key
Connection timed outVerify the IP address in your dashboard

Was this article helpful?