Connect to your Linux VPS with SSH from Windows, Mac or Linux
Find your login details, connect over SSH from Windows, macOS or Linux, confirm the host key, save a shortcut and fix the most common first-login errors.
- Beginner
- Linux VPS
- 3 min read
SSH (Secure Shell) is how you manage a Linux VPS: an encrypted terminal session to your server. Every modern desktop already includes an SSH client, so there is nothing to buy or install on Windows 10/11, macOS or Linux.
What you need
All three details are in the client area under Services, on your server's page:
- The server's IP address, for example
203.0.113.25. - The username, which is
rooton a fresh Linux VPS. - The root password.
1. Open a terminal
- Windows 10 or 11: open Windows Terminal or PowerShell from the Start menu. The OpenSSH client is built in.
- macOS: open Terminal (Applications → Utilities).
- Linux: open your terminal app. If
sshis missing, install theopenssh-clientpackage.
2. Connect
ssh [email protected]If your server listens on a different SSH port, add -p and the port number:
ssh -p 2222 [email protected]3. Confirm the host key the first time
On the first connection SSH shows the server's fingerprint and asks Are you sure you want to continue connecting (yes/no/[fingerprint])?. Type yes and press Enter. Your computer saves the key in ~/.ssh/known_hosts and will warn you if it ever changes.
For extra certainty, open the browser console in the control panel and run ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub. The fingerprint it prints should match the one your terminal showed.
4. Enter the password
Paste or type the root password and press Enter. Nothing appears on screen while you type. That is normal. When you see a prompt such as root@node-linux-1234:~#, you are in.
Using PuTTY instead (Windows)
If you prefer a graphical client, install PuTTY from its official site (putty.org links to the download page).
- In Host Name, enter the IP address. Leave Port at
22unless you changed it. - Under Saved Sessions, type a name and click Save so you do not have to retype it.
- Click Open, accept the host key, and log in as
root.
Save a shortcut
Typing the IP every time gets old. Create or edit ~/.ssh/config on your computer (on Windows it is C:\Users\<you>\.ssh\config):
Host myvps
HostName 203.0.113.25
User root
Port 22
ServerAliveInterval 60Now ssh myvps is enough. ServerAliveInterval stops idle sessions from being dropped by home routers.
Troubleshooting
- Connection timed out: the server is stopped, the IP is wrong, or a firewall is dropping port 22. Check the server is running in the client area.
- Connection refused: the server answered but nothing listens on that port. SSH may be stopped or on another port.
- Permission denied: wrong username or password, or password logins are disabled and you need your key.
- REMOTE HOST IDENTIFICATION HAS CHANGED: expected after an OS reinstall. Remove the old key with
ssh-keygen -R 203.0.113.25and connect again. If you did not reinstall, stop and contact support before continuing.
If SSH will not connect at all, click Open Control Panel on your service page and use the browser console. It works even when SSH or the network settings are broken.
For a step-by-step checklist, see Fix SSH "connection refused" and "timed out" errors.
Next steps
- First steps after your Linux VPS is ready
- Set up SSH keys so you no longer need the password
- Create a sudo user on Linux
Was this guide helpful?
Still stuck?
Ask RunRacks AI for a quick answer, or open a ticket and our team will take a look at your server.
Related guides
Getting started
Edit files with nano: a beginner's guide
Open, edit, search and save files with the nano text editor on a Linux server, including cutting and pasting lines, showing line numbers and safely editing system config files with sudo.
- Beginner
- Linux VPS
- 5 min read
Getting started
Your first hour with a new RunRacks server
A step-by-step roadmap for the first hour after your RunRacks server is delivered, from finding your login details to changing the password, updating the OS and picking your next guides.
- Beginner
- All
- 5 min read
Getting started
How to choose a server location
Pick a data center location based on where your users, broker or team are, confirm it with ping tests, and weigh the legal and latency points that come with each choice.
- Beginner
- All
- 4 min read