windows rdp access

All the Windows-based nodes at Jelastic provide the embedded Remote Desktop Protocol support, which allows you to connect to the virtual desktop of your Windows machine and perform any required server configurations through it.

In order to ensure the maximum convenience while using the Windows hosting services, our platform is equipped with the integrated RDP tool - Guacamole. It represents a clientless remote desktop gateway, which is run from within the web-browser by virtue of HTML5 and does not require any additional plugins or client software installed.

Besides this default connection scenario, you can also use your preferred local remote desktop client. So, below we’ll describe both ways of the remote desktop connections' establishment in more details:

RDP Connection via Web Client

The required workflow for accessing the server’s desktop is similar for all Windows VM nodes. For instant access just after the node’s creation, you can use the direct one-time Guacamole link in the received email. Otherwise, the required operations should be performed through the dashboard.

Let’s consider it on the example of the Windows VM server.

1. Expand the dedicated Remote Desktop list next to the Windows-based node (or layer) and click the Open in Browser button.

remote desktop menu in dashboard

The other available options are required for connection via the local RDP client:

  • Reset RDP Password to reset and resend Administrator credentials
  • Info, which displays short information on establishing the RDP connection manually
  • RDP link for establishing the RDP connection via your local client

2. Remote desktop connection will be established in a new browser tab.

remote desktop web client access

Once the connection is established, you’ll see the Server Manager window opened. Now, you can start managing your server.

RDP Connection via Local Client

In case you prefer to work with a local remote desktop client, you’ll need to use the credentials from the email notification sent to you during the corresponding environment creation. The tools you may want to use are: Remote Desktop (for Windows), KRDCRemina or RDesktop (for Linux), Microsoft Remote Desktop (for Mac OS X).

Below, we’ll describe the examples of working with the most common RDP clients for Windows and UNIX-based operating systems:

For Windows

1. Get the Microsoft Remote Desktop application and launch it.

2. Click Add > PC at the top of the opened window.

Windows remote desktop application

3. Provide the RDP connection link into the PC name field.

provide RDP connection link

Tip: You can get the required link (endpoint) from the after-creation email or via the dashboard:

  • environment settings > endpointsWindows VM RDP endpoint

  • Remote Desktop menu for nodeWindows VM RDP link

Also, if public IP is attached to the node, it can be used instead of the endpoint.

4. Click the + button next to User account and specify your account credentials (view the appropriate email).

provide Windows VM access credentials

Click Save and adjust any additional setting, if needed.

That’s all, your connection is saved under the “Saved Desktops” section. Click it to start a remote session.

For Linux/MacOS/FreeBSD

We’ve chosen the rdesktop utility as an example of the RD client. If you haven’t got this tool installed at your local computer, get it using the appropriate command according to your OS package manager (e.g. yum -y install rdesktop or sudo apt-get install rdesktop).

Then open your terminal emulator and follow the next steps:

1. The easiest way to connect to the remote desktop is to execute the next command:

1
rdesktop {access_url}

where {access_url} is a connection URL for RDP access (can be seen at the dashboard or inside the received email), specified without the protocol-defining part.

Unix RDP access

Note: An environment with the required server should have the Running status; otherwise, you’ll receive the Unable to connect error.

2. In the opened window, you’ll need to log in with the credentials from the same email.

Unix RDP credentials

Note: Another way is to specify your login and password directly in the connection string:

1
rdesktop -u {username} -p {password} {access_url}

Unix connection with credentials

In such a way, you’ll bypass the login screen and will access the desktop immediately.

Once the authentication is done, you’ll see the remote virtual desktop of the required node opened.

Now, you can start configuring your server using the in-built Server Manager.