Skip to content

Connecting to ECC

Connecting to Linux and Windows virtual machines (VMs) and bare-metal servers (BMs) on ECC.

Linux ECC servers

Secure Shell (SSH) can be used to connect to Linux servers. The following applies to both VMs and BMs running Linux.


Change permissions on your Private Key file (only needs to be done once)

chmod 400 private-ssh-key.pem

Connect to your server

ssh -i private-ssh-key.pem -p [SSH Port] [SSH User]@[SSH IP]


Windows users can connect over SSH using PuTTY. First, your Private Key must be converted to another format (only needs to be done once).

  1. Download and install the PuTTY MSI (Windows Installer).
  2. Open PuTTYgen, click Load and choose private-ssh-key.pem.
  3. Click Save private key, and save as e.g. putty-key.ppk.
  4. Right-click on putty-key.ppk and choose Load into Pageant.

The key will be automatically loaded into memory. You can now connect.

  1. Open PuTTY and set this in the Category: Session
    • Host Name: [SSH User]@[SSH IP]
    • Port: [SSH Port]
    • Connection type: SSH
  2. Save your PuTTY session and click Open!


Windows ECC servers

Remote Desktop Protocol (RDP) can be used to connect to Windows servers. The [RDP IP] and [RDP Port] information is found in the Info dropdown menu for your VM. Password is chosen during VM deployment on ICE Connect. Note that both Remote Desktop Connection and FreeRDP will warn you about the automatically generated self-signed certificate.


Connect using the command line RDP client FreeRDP.

xfreerdp /u:"Administrator" /v:[RDP IP]:[RDP Port]


Connect to Windows WMs using Remote Desktop Connection.

Assuming [RDP IP] = and [RDP Port] = 12345

remote desktop connection

Last update: 2023-04-12
Created: 2022-12-29