SALES: 1-800-867-1380

Connect to an Azure virtual machine with RDP or SSH

Updated: February 26, 2015

This article gives you requirements and troubleshooting tips for using Remote Desktop Protocol (RDP) or a Secure Shell (SSH) client to connect to an Azure virtual machine so you can log on. To get instructions instead, see:

You’ll need the following:

  • The user name and password of an account on the virtual machine with administrator privileges. This is usually the account that was set up when the virtual machine was created. If you created a Linux VM, you might have used the default user name of ‘azureuser’.

  • TipTip
    If you forgot the user name or password for your VM, the VMAccess extension can help you fix this. You don’t need to know the existing password to use the extension, but you do need the VM agent installed. The agent is usually installed, but it might be missing if you used your own image to create the VM.

    For Linux VMs – To get the Linux agent, see the Github repo. To get the extension, see Using VMAccess Extension to Reset Login Credentials for Linux VM.

    For Windows VMs -- Download the Windows version here. To get the extension, see VM Agent and Extensions – Part 2.

  • Access to the virtual machine through an endpoint. The endpoint provides the access through a public port, a private port, and the specified protocol.

    This endpoint is usually set up for you automatically when you create a virtual machine in the Management Portal. If you use the Quick Create option, it’s set up automatically. If you choose the From Gallery option, an endpoint is set up for Remote Desktop or SSH unless you remove the endpoint while you’re configuring the virtual machine. To check or set up endpoints on an existing virtual machine, see How to Set Up Endpoints to a Virtual Machine.

  • The firewall of the guest operating system configured to allow access.

    This is done automatically if you use an image provided by Azure to create the virtual machine. If you use an image you’ve uploaded, make sure to configure it for remote access before you upload it.

Here are a few tips you can try if you have problems connecting:

  • Try to start the connection again. When you’re prompted for password, look at the domain information that’s added to the user account. If it’s not the correct domain for the user account on the virtual machine, specify the correct domain. For example, in Remote Desktop Connection, you can select Other User, add a backslash before user name and then type the password.

  • Restart the virtual machine.

  • Delete and then recreate the endpoint for Remote Desktop or SSH. When you recreate the endpoint, use the default values.

  • Try to connect from a different network. If you are using a corporate network, try a network that’s separate from the corporate network. If that works, it indicates that the corporate network doesn’t allow that type of connection. For example, the connection might be blocked by the corporate firewall. Contact your corporate network administrator for help.

If none of those tips work, you might need to resize or recreate the virtual machine. For detailed instructions on troubleshooting, see Troubleshooting Endpoint Connectivity.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
© 2015 Microsoft