How to connect to your instance



Connect to your Linux instance via SSH from Windows:

  • 1  We recommend to use PuTTY to connect to the terminal of the instance. First we need to convert the AWS key file to a PuTTY key file. Open PuTTY Key Generator on your local machine. Click on 'Load' and select your AWS key file (.pem), which you created when you launched the instance.


  • 2  Click on 'Save private key', then click on 'Yes' in the popup. Save the key file on your computer.
  • 3  Open PuTTY now. In 'Host Name', type in 'ubuntu@' and the IPv4 Public IP of your instance.


  • 4  Expand 'SSH' in the left panel. Then click on 'Auth'. Browse for the PuTTY key file we saved in step 2. Click on 'Open' to establish a connection to the terminal of your instance.


  • 5  After the connection is established you see the following screen. Note: Updating packages should be done, but can cause an incompatibility in the integration of Selenium.




Connect to your Linux instance via SSH from MacOS:

  • 1  Put the AWS instance key file (.pem), which you created when you launched the instance, in any directory you want.

  • 2  Launch a terminal window and connect to your instance by:
    ssh -i /path/to/key-file.pem ubuntu@publicIPaddress
    The response will look similar to:

  • 3  By answering with 'yes' you are connected to the instance.


Connect to your Linux instance for file transfer via WinSCP:

  • 1  This steps are using the SCP client software 'WinSCP' (recommended for Windows), but you can use any other SCT/FTP client as well. Open WinSCP and enter the IPv4 Public IP of your instance into the Host Name. The username is 'ubuntu', the password remains empty.


  • 2  Click on 'Advanced'. Select 'Authentification' in the left pane, then browse for your PuTTY key file.


  • 3  Click on 'Ok' and then on 'Login'.


Connect to your Linux instance for file transfer via Cyberduck:

  • 1  This steps are using the SCP client software 'Cyberduck' (recommended for Mac), but you can use any other SCT/FTP client as well. Open Cyberduck, click on 'Open Connection' and enter the following parameters:
    Dropdown: SFTP (SSH File Transfer Protocol)
    Server: The public IP Adress of your instance
    Port: 22
    Username: ubuntu
    SSH Private key: /path/to/key-file.pem

  • 2  In the following popup click on 'Allow', then you are connected for file transfer.



Connect to your Linux instance via RDP or VNC:

  • 1  We first need to open the ports for RDP and VNC in the AWS Management Console. Click on the Security Group of your instance. Click on 'Inbound' -> 'Edit' -> 'Add Rule'. If you want to connect via RDP, select 'RDP' in the drop down box. If you want to connect via VNC, select 'Custom TCP Rule' and enter '5901' into 'Port Range'. When you are done, click on 'Save'.


  • 2  The username for the RDP/VNC connection is 'guiuser', the password for this user are the first 8 chars of your AWS instance ID.


  • 3  RDP: Open Remote Desktop Connection application on your local device, Enter the IPv4 Public IP of your instance and click on 'Connect'. In the appearing popup enter the user credentials from step 3.


  • 4  VNC: Open TightVNC Viewer application on your computer. Enter the IPv4 Public IP of your instance followed by ':5901' into Remote Host. Click on 'Connect', in the following popup, enter the password 8 chars password from step 3.




Connect to your Windows instance:

  • 1  Open Remote Desktop Connection application on your local device.
  • 2  Enter the IPv4 Public IP of your instance and click on 'Connect'.
  • 3  The username is 'Administrator'. The password can be found in the AWS Management Console.
  • 4   In the AWS Management Console select your instance -> click on 'Actions' -> click on 'Get Windows Password'. Open the key file you created when you launched the instance. Click on 'Decrypt Password'.

  • 5  Copy the password into the Remote Desktop Connection application and click on 'Connect'