Logging In and SSH Keys

Before you continue on this page, make sure you have an Argonne Domain or Argonne Collaborator account and can login to the LCRC Accounts page. In addition, you MUST join an LCRC project before you can login as well. For details on how to obtain an account and join a project, please see our Getting an LCRC Account page.

Next, in order to log in to the LCRC clusters, you will need to set up SSH Keys. SSH (Secure SHell) is a network protocol that provides a secure way to access a remote computer. Depending on your operating system, you may or may not have to install a third-party SSH client in order to log in.

LCRC currently runs several clusters. Following the directions below, you may interchange the cluster name based on your needs as they both use the same SSH keypair and filesystems. Bebop is currently the primary cluster and most users will be using this.

Once you’ve finished following the steps on this page to get logged into the LCRC clusters, please read the following documentation on how to manage your LCRC Project Time and Allocations: Projects in LCRC

After that, you can then read the following documentation on how to use the LCRC resources including submitting jobs to the clusters and loading software for example: Using LCRC

Linux / Unix

Most modern Linux and Unix distributions come with OpenSSH or a similar SSH client. To check, open up a terminal and run the following command (with a capital V):

$ ssh -V
OpenSSH_5.3p1, OpenSSL 1.0.1e-fips 11 Feb 2013

It should print out the name and version of the client. If it says OpenSSH, you can follow the generic OpenSSH setup instructions to create your SSH key pair and log in.

macOS / OS X

Apple’s operating system comes with the OpenSSH client. To use it, you’ll need to use the Terminal application. Open Spotlight by pressing Space, type “terminal”, and hit Return to launch Terminal. You can now follow the generic OpenSSH setup instructions to create your SSH key pair and log in.


Newer versions of Windows allow for the same OpenSSH instruction listed in the previous sections. Alternative, some users continue to use the PuTTY SSH client to log in. See our PuTTY setup instructions to get started with PuTTY if needed.


If you are running an operating system that has not been mentioned above, or you want to try a different SSH client, shoot us an email at [email protected] and we can help you get set up or point you towards a preferred client.

Logging In and SSH Keys Sidebar