The VMware Knowledge Base provides support solutions, error messages and troubleshooting guides
Connecting to an ESX host using an SSH client (1019852)
Note: These steps can be used on an ESX 3.x or 4.x host. These steps do not apply to ESXi.
For information on using SSH with other versions, see Tech Support Mode for Emergency Support (1003677).
By default, root login via SSH is disabled to prevent brute force attacks. This articles details how to create a new user on the ESX host, log in as the new user, then change to root access so you have the correct privileges to administer the ESX host.
This article assumes you have the SSH client and the vSphere Client or VMware Infrastructure Client installed. The video also assumes you have configured your ESX host's service console network. If you can ping the ESX host service console IP, you can proceed. For more information, see Testing network connectivity with a ping command (1003486).
To connect to the ESX host using an SSH client:
- Log into ESX host as the root user with the vSphere Client.
- Click Users & Groups.
- Right-click on a blank area and click Add.
- Enter a username and password. Confirm your password. Starting in ESX 4.0, the password must be at least 8 characters in length.
- Select Grant shell access to this user and click OK.
- Open your SSH client.
- Complete the necessary fields. Ensure Port is set to 22 and Protocol is set to SSH. Press Enter or click Open.
- Log in as the new user you created in step 4.
- Change to the root user account:
su -and press Enter. This command switches the user to root access and provides the path to the root user commands.
- Enter the root password and press Enter. You are now logged into the ESX host via SSH as root.
- When you are done administering the system, type
Exitand press Enter. This reverts to your new ESX user.
Exitand press Enter again. You have successfully disconnected from your SSH session.
su -, see Enabling root SSH login on an ESX host (8375637).
Request a Product Feature
To request a new product feature or to provide feedback on a VMware product, please visit the Request a Product Feature page.