HiPerGator Terminal Interface¶
Quick information
- Hostname:
hpg.rc.ufl.edu
- Port (only needed for SSH key authentication):
- For most users connecting with a GatorLink:
22
for password authentication, or2222
for SSH key. - For federated users connected via eduVPN:
22
- For most users connecting with a GatorLink:
Introduction¶
Terminal is a classic Linux/Unix interface that presents you with an interactive shell (bash, csh, etc.) on login and allows you to use typed commands into 'standard input' stream of the terminal that will results in execution of programs and output to 'standard output' or 'standard error' stream of the terminal. All of the streams can be redirected to files or 'piped' to other commands. You are encouraged to learn more on your own. The default shell on HiPerGator is 'bash' or Bourne Again Shell.
Command-line interface (Terminal) can be accessed via SSH, or from a web interface. Both Open OnDemand and JupyterHub have built-in terminal emulators that will open a terminal session directly on HiPerGator without a need to connect to HPG via ssh, but they have some other limitations and somewhat awkward copy-paste mechanisms because they are run through the web browser instead of a full-featured terminal emulator you would run on your computer to connect via SSH. Both approaches have trade-offs. Please consider them carefully when choosing the method that works for you.
SSH connections can also be used by individual applications running on your local computer, like Bitvise.
SSH Connections¶
Connect to HiPerGator via SSH to hpg.rc.ufl.edu
using your HiPerGator username, which is typically your GatorLink or, for federated users, a modified version of your account provided when your account was created.
The default SSH port port 22, is used for GatorLink users using password authentication or federated users after connecting with the eduVPN.
Port 2222 can be used for GatorLink users who have set up SSH Key authentication.
Warning
The default ssh port 22 requires GatorLink password authentication, whereas port 2222 is used for SSH key authentication.
Note that the UF security requirements include the use of Multi-Factor Authentication when connecting to HiPerGator. See the SSH Multiplexing article to help reduce the frequency of MFA confirmations.
SSH Terminal application¶
Note
- For any given command below,
username
should be replaced with your HiPerGator username (same as your GatorLink username for UF users or a specific HiPerGator username created for federated users). - You may omit your GatorLink if the username on your local computer matches your GatorLink username
Open the Terminal application found on MacOS, Linux, and most newer Windows computers and run:
ssh username@hpg.rc.ufl.edu
or
ssh hpg.rc.ufl.edu
You will be prompted for your password. After the correct password is entered, you can select the method to use to receive your Duo MFA prompt or enter a six-digit code.
An example of the connection for the user, username
, is below:
PS C:\Users\username> ssh username@hpg.rc.ufl.edu
(username@hpg.rc.ufl.edu) Password:
(username@hpg.rc.ufl.edu) Duo two-factor login for username@ufl.edu
Enter a passcode or select one of the following options:
1. Duo Push to XXX-XXX-1234
2. Phone call to XXX-XXX-1234
3. Phone call to XXX-XXX-4321
Passcode or option (1-3): 1
Success. Logging you in...
Using Graphical SSH Clients¶
For University-managed computers, the following SSH Clients are pre-approved for open and restricted data in UF's IRM Fast Path Solutions:
Details of using Bivise are on this page.