Connect to your VM with PuTTY

Find your VM's address, port and username, then log in over SSH from Windows using PuTTY.

Updated 6 November 2026

PuTTY is a free SSH client for Windows, and it's the best way to work on a VM. If you're wondering why not just use the console on the panel, here's why.

On a Mac or Linux, you don't need it. The Info tab has an ssh command ready to copy into a terminal.

Windows VMs don't use SSH. Download the .rdp file from the Ports tab, open it, and log in with the password on the Info tab.

What you need

Open your VM on the panel and look at Logging in on the Info tab.

You need Where it is Example
Host The address in the SSH line 203.0.113.10
Port The number after the colon, or after -p 40001
Username Username on the same tab ubuntu
Your private key The .ppk file you made with PuTTYgen my-key.ppk

Use the public address and port shown there, not the Private IP. The private address only works from inside your project's network.

Usernames depend on the system: ubuntu, debian, almalinux, rocky or arch. Log in as that user rather than root, which these systems normally refuse.

Set up PuTTY

  1. Open PuTTY. On the Session page, enter the Host Name and Port, and leave Connection type on SSH.
  2. Go to Connection > Data and enter your username under Auto-login username.
  3. Go to Connection > SSH > Auth > Credentials. Press Browse next to Private key file for authentication and pick your .ppk file. On older versions of PuTTY, this is on the Auth page.
  4. Go back to Session, type a name under Saved Sessions, and press Save. Next time you can just double-click it.
  5. Press Open.

The first time, PuTTY shows a Security Alert because it hasn't met this server before. Press Accept. It remembers the server and only warns you again if something changes.

You're in when you see a prompt like ubuntu@my-vm:~$. To run something as root, put sudo in front of it.

If your VM has no key on it

A VM built without your key won't let you in with one yet. VMs like this have one of two ways in, shown under Logging in:

  • Show the password. A VM built without the guest agent has a lasting password. Press this to read it.
  • Turn on SSH password login. Other VMs have no lasting password. This makes a new one and shows it once, then turns password login off again when the time shown runs out, 30 minutes by default. The VM has to be running.

In PuTTY, leave the private key blank and type the password when asked. To paste into PuTTY, right-click. Nothing appears on screen as you do, which is normal.

Once you're in, put your key on the VM and press Turn it off now.

Keep things running after you disconnect

If your connection drops, whatever you were running in that session stops with it. For anything long, such as a big download or an upgrade, run tmux first (install it if it's missing). If you get cut off, connect again and run tmux attach to pick up where you left off.

Copying files

The same details work for SFTP. In WinSCP, choose SFTP, enter the host, port and username, and pick your key under Advanced > SSH > Authentication.

If it won't connect, see Why can't I reach my VM?