Bridges User Guide



Connecting to Bridges


Before the first time you connect to Bridges, you must create your PSC password.  Depending on your preferences, you may want to change your login shell once you are logged in. 

If you have questions at any time, you can send email to

Content of this document

This document will tell you how to 


Create or change your PSC password

If you do not already have an active PSC account, you must create a PSC password (also called a PSC Kerberos password) before you can connect to Bridges.  Your PSC password is the same on all PSC systems, so if you have an active account on another PSC system, you do not need to reset it before connecting to Bridges.

Your PSC password is separate from your XSEDE Portal password. Resetting one password does not change the other password. 

Setting your initial PSC password

To set your initial PSC password, use the web-based PSC password change utility.

See PSC password policies.

Changing your PSC password

There are two ways to change or reset your PSC password:

When you change your PSC password, whether you do it via the online utility or via the kpasswd command on one PSC system, you change it on all PSC systems.


Connect to Bridges

When you connect to Bridges, you are connecting to one of Bridges' login nodes.   The login nodes are used for managing files, submitting batch jobs and launching interactive sessions.  They are not suited for production computing.  

See the Running Jobs section of this User Guide for information on production computing on Bridges.

There are several methods you can use to connect to Bridges.

  • ssh, using either XSEDE or PSC credentials.  If you are registered with XSEDE for DUO Multi-Factor Authentication (MFA), you can use this security feature in connecting to Bridges.

    See the XSEDE instructions to set up DUO for MFA.

  • gsissh, if you have the Globus toolkit installed
  • XSEDE Single Sign On, including using Multi-Factor authentication if you are an XSEDE user



You can use an ssh client from your local machine to connect to Bridges using either your PSC or XSEDE credentials. 

SSH  is a program that enables secure logins over an unsecure network.  It encrypts the data passing both ways so that if it is intercepted it cannot be read.

SSH is client-server software, which means that both the user's local computer and the remote computer must have it installed.  SSH server software is installed on all the PSC machines. You must install SSH client software on your local machine. 

Read more about ssh in the Getting Started with HPC document.

Once you have an ssh client installed, you can use either your PSC credentials or XSEDE credentials (optionally with DUO MFA) to connect to Bridges.    Note that you must have created your PSC password before you can use ssh to connect to Bridges.

Use ssh to connect to Bridges using XSEDE credentials and (optionally) DUO MFA:

  1. Using your ssh client, connect to hostname  or  using port 2222.
    Either hostname will connect you to Bridges, but you must specify port 2222.
  2. Enter your XSEDE username and password when prompted.
  3. (Optional) If you are registered with XSEDE DUO, you will receive a prompt on your phone.  Once you have answered it, you will be logged in.

Use ssh to connect to Bridges using PSC credentials:

  1. Using your ssh client, connect to hostname  or  using the default port (22).
    Either hostname will connect you to Bridges. You do not have to specify the port.
  2. Enter your PSC username and password when prompted.


 Read more about using SSH to connect to PSC systems



If you have installed the Globus toolkit you can use gsissh to connect to Bridges. Gsissh is a version of ssh which uses certificate authentication.   Use the command myproxy-logon to get a suitable certificate. The Globus toolkit includes a man page for myproxy-logon.

See more information on the Globus Toolkit website.


Public-private keys

You can also use the public-private key pair method to connect to Bridges. To do so you must first fill out our form for this type of access.


XSEDE single sign on

XSEDE users can use their XSEDE usernames and passwords in the XSEDE User Portal Single Sign On Login Hub (SSO Hub) to access  or    

You must use DUO Multi-Factor Authentication in the SSO Hub.

See the XSEDE instructions to set up DUO for Multi-Factor Authentication.


Change your default shell

The change_shell command allows you to change your default shell.   This command is only available on the login nodes.

To see which shells are available, type

change_shell -l

To change your default shell, type

change_shell newshell

where newshell is one of the choices output by the change_shell -l command.   You must use the entire pathoutput by change_shell -l, e.g. /usr/psc/shells/bash.  You must log out and back in again for the new shell to take effect.