Developers

How to Connect to Your VPS with SSH from Windows, Mac or Linux

Make your first SSH connection to a VPS from Windows, macOS or Linux, understand the fingerprint prompt, save a shortcut and fix the most common errors.

By Zebra Hosting Cloud

You have a new VPS and the login details for it. Now you need to get in. A VPS (virtual private server) is your own private part of a server, and SSH (Secure Shell) is the encrypted way to log in to it and type commands. This guide shows you how to make that first connection from Windows, macOS or Linux, what the fingerprint question means, how to save a shortcut and how to read the three most common errors. The steps are the same for a developer in Tirana or a shop owner in Pristina.

What you need before you connect

Look in the details you received for your server. You need four things, and they work the same way on a VPS or a dedicated server:

  • The IP address. This guide uses 203.0.113.10, an address reserved for examples. Use yours instead.
  • The username. With full root access this is often root, the main admin account.
  • The password, or an SSH key if you set one up. A key replaces the password with a pair of files; that is a topic for its own guide.
  • The port. A port is like a door number on the server. SSH uses port 22 unless it was changed.

One tip: when you type a password over SSH, nothing appears on screen. No dots, no stars. That is normal. Type it and press Enter.

Connect from Windows: PowerShell, Windows Terminal or PuTTY

Windows 11 and recent versions of Windows 10 include an SSH client, so you can start right away.

PowerShell or Windows Terminal

  1. Click Start, type Terminal (or PowerShell) and open it.
  2. Type ssh [email protected] and press Enter.
  3. Answer the fingerprint question explained below, then type your password.

If your port is not 22, add -p and the number, for example ssh -p 2222 [email protected]. If Windows says ssh is not recognized, open Settings, search for Optional features and add OpenSSH Client.

PuTTY

PuTTY is a free SSH program for Windows that keeps your servers in a saved list. Download it only from the official PuTTY website and install new versions when they come out, because they fix security problems.

  1. On the Session screen, type your IP address in Host Name (or IP address).
  2. Check that Connection type is SSH and that Port matches your port, usually 22.
  3. To keep it, type a name such as my-vps under Saved Sessions and click Save.
  4. Click Open. When PuTTY shows login as:, type your username, then your password.

Connect from macOS and Linux with Terminal

Macs and Linux computers have SSH built in. On a Mac, open Terminal from Applications > Utilities. On many Linux desktops, you can find Terminal in the app menu or press Ctrl+Alt+T. Then type:

ssh [email protected]

The -p option for a different port works here too. When you finish, type exit to close the session.

The first-connection fingerprint prompt, explained

The first time you connect, you will see something like this:

The authenticity of host '203.0.113.10 (203.0.113.10)' can't be established.
ED25519 key fingerprint is SHA256:...
This key is not known by any other names.
Are you sure you want to continue connecting (yes/no/[fingerprint])?

This is not an error. Every server has a host key, a kind of ID card, and the fingerprint is a short summary of it. Your computer has never met this server, so it asks if you trust it.

Type yes and press Enter. Your computer stores the key in a file called known_hosts and will not ask again for this server. In PuTTY, the same question appears as a security alert; click Accept. If you can get the fingerprint from a trusted source, such as a colleague who already uses the server, compare the two first.

Later, you may see a loud warning that the remote host identification has changed. This is expected after the server's operating system is reinstalled. If you know that is the reason, remove the old entry and connect again:

ssh-keygen -R 203.0.113.10

If you did not expect a change, do not connect. Ask your host first.

Save time with an SSH config shortcut

An SSH config file gives each server a short name, so you stop typing the full address. It is a plain text file named config, with no file extension, inside a folder called .ssh in your home folder:

  • macOS and Linux: ~/.ssh/config
  • Windows: C:\Users\yourname\.ssh\config

Create the file if it does not exist and add a block like this:

Host myvps
    HostName 203.0.113.10
    User root
    Port 22

Save it, and ssh myvps now does the same job as the long command. On Windows, check that Notepad did not save the file as config.txt. PowerShell, Windows Terminal, macOS and Linux all read this file; PuTTY uses its own Saved Sessions instead.

Connection refused, timed out or permission denied: what each means

Most failed connections end with one of three messages. Each points to a different place to look.

MessageWhat it meansWhat to check
Connection refusedThe server answered, but nothing is listening for SSH on that port.The port number, whether the SSH service is running, and firewall rules on the server.
Connection timed outNothing answered at all.The IP address, whether the server is running, the server firewall, and your own network. Some office and public Wi-Fi networks block port 22.
Permission deniedYou reached SSH, but the login failed.The username, the password (watch Caps Lock and your keyboard layout, for example Albanian or English) and the key file, if you use one.

To test whether the port is reachable, run Test-NetConnection 203.0.113.10 -Port 22 in PowerShell, or nc -vz 203.0.113.10 22 on a Mac or Linux. For a step-by-step log of any attempt, add -v: ssh -v [email protected].

If you ask for help, send that log, but never your password. Our knowledge base is the place to look for other questions.

Running your own VPS with Zebra Hosting

Every Zebra Hosting VPS plan includes a dedicated IPv4 address and full root access, and you choose the operating system at checkout: Ubuntu, Debian or AlmaLinux, or another system on request. Our team prepares the server and delivers it within 24 hours. It runs in our data center in Pristina, close to your visitors in Kosovo, Albania and the rest of the Balkans.

If a connection will not work, open a ticket, send an email or call us. Real people answer tickets in 17 languages, including Albanian and English.