Skip to main content

System Connection via SSH Gateway

For connecting to NREL's high-performance computing (HPC) systems, users—both at NREL and remotely—can use the SSH gateway.

Connecting via the SSH gateway requires no additional software, only an SSH client called PuTTY, so you can use this method even if you cannot install software on your computer. It's also the method you'll need to use if your firewall blocks virtual private network (VPN) connections.

For security reasons, you cannot use SSH gateway connections for tunneling, X11 visualization, or file transfers. You'll need a VPN connection for those tasks.

NREL Users

If you're using an NREL computer, follow these instructions for connecting via the SSH gateway.

You'll need your HPC username and password to proceed. With that, you can SSH directly to Peregrine or other HPC systems.

On Windows: Follow the PuTTY documentation to connect.
On Mac or Linux: Use the built-in Terminal app to execute the following command:

ssh <username>@<system>.hpc.nrel.gov

For example, to connect to Peregrine, use ssh <username>@peregrine.hpc.nrel.gov

First time logging in?

If this is the first time you've logged in with your new account, you will be prompted to change your password.

First, enter your existing password.

Next, enter in a new password. You will be prompted to enter it a second time, then you will be logged off. Just reconnect with your newly set password and you're ready to go!

Trouble? Please contact us.

To change your HPC password at any time, you can simply use the passwd command.

Remote Users

If you’re connecting remotely on a non-NREL computer, follow these instructions for connecting via the SSH gateway.

You'll need your HPC username, password, and an OTP token to proceed. With that, you can SSH to the gateway server, and from there, jump to Peregrine or other HPC systems.

gateway server: hpcsh.nrel.gov
username: Your HPC username
password: Your HPC password PLUS the 6-digit token

On Windows:Follow the PuTTY documentation to connect. Make sure to connect to host hpcsh.nrel.gov.

On Mac or Linux: Use the built-in Terminal app to execute the following command:

ssh <username>@hpcsh.nrel.gov

The first time you log in you will be prompted to verify the RSA/ECDSA key fingerprint. Depending on which version of OpenSSH you're using, you will see one of the fingerprints below. Verify the fingerprint matches one of these and enter yes. If the fingerprint does not match, please contact us.

For the RSA key fingerprint (md5 hash in hex format)

Screenshot of the fingerprint

or for the ECDSA key fingerprint (md5 hash in hex format)

Screenshot of the fingerprint

or these are the SHA256 hashes shown in OpenSSH 6.8 and newer (in base64 format):

ECDSA SHA-256 D4PVzzJp19f67JKjq8e2NWGt41yragvpkYHdtIs1rEo
RSA SHA-256 tcLwOzN7vW5f+4ulUVggl3f690QEyLk31mZHReV3+W0

Example

Assume your username is juser, your password is ^somEAw40meB4zz, and the token displays 392954.

Windows: Open PuTTY and connect to hpcsh.nrel.gov

Mac or Linux: Open Terminal and run ssh juser@hpcsh.nrel.gov

At the password prompt, enter your password combined with the token display:
^somEAw40meB4zz392954

After a few seconds, you should be logged into the hpcsh gateway server. From there, you can ssh to Peregrine or other HPC systems by executing the command:

ssh <system>.hpc.nrel.gov

For example, to connect to Peregrine, use ssh peregrine.hpc.nrel.gov

You will be prompted to log into the new system; use your username and password only (no token).

First time logging in?

If this is the first time you've logged in with your new account, you will be prompted to change your password.

First, enter your existing password.

Next, enter in a new password. You will be prompted to enter it a second time, then you will be logged off. Just reconnect with your newly set password and you're ready to go!

Trouble? As always, contact us.

To change your HPC password at any time, you can simply use the passwd command.