Linux VM: Setting Up SSH
Warning
If you are opening up the ssh port, then it is recommended that you change
the password of the student user to something other than the default!
# To change the current user's password run:
student@hacs408e-vm ~> passwdPort Forwarding (Recommended)
Get the IP address of your class Linux VM at https://lab.aces.umd.edu
You will first need to get the IP address of your Linux VM. Log in through the web user interface and start up the virtual machine if it isn’t already running. Then, run the following in a terminal:
student@hacs408e-vm ~> ip -c aSet up a new port forwarding rule at https://ams.aces.umd.edu
Note
You will need to be on UMD’s Wi-Fi or connected to their VPN to access the site.
For the three fields to fill in use:
| Field | Description |
|---|---|
Machine IP | Use the ip address of your Linux VM |
Machine Port | Use port 22 which is the default port that the ssh server listens on. |
| `Machine Description | Doesn’t matter what you put here, but it must be something. |
Once you add a new port forwarder, you should see something like this:

This shows a blurred out port indicated by the red box. You can now use this port to ssh to your Linux VM.
Connect to the class VM from using an SSH client.
Using ssh from a terminal on your local machine, run the following command to
connect to the class Linux VM. Don’t forget to replace PORT_NUM with the
actual forwarded port specified on the site.
ssh student@jump.aces.umd.edu -p PORT_NUMTip
Check out the ssh-copy-id
man page if you
want to be able to automatically sign in as the student user without entering
your password.
You will need to run ssh-copy-id for each ssh connection:
# Enter UMD password to copy private key to Aces class VM
ssh-copy-id -p $PORT lmains@vm.aces.umd.edu
# Enter `student` password to copy private key to HACS408E VM
ssh-copy-id -J lmains@vm.aces.umd.edu:$PORT student@hacs408e-vmViewing GUI Programs over SSH
You will need an X11 server running on your host machine to view GUI programs over ssh. Here are the recommended programs for each OS.
| OS | Program |
|---|---|
| Windows | Free Option: MobaXTerm |
| MacOS | Free Option: XQuartz |
| Linux | If you set up your ssh config as above, you should be good to go! Otherwise, make sure to add -X when you ssh to the VM. |