Secure Shell

From HPC documentation portal
Jump to: navigation, search


An SSH client (ssh) is the required tool to connect to our facilities. An SSH client provides secure encrypted communications between two hosts over an insecure network.

This page contains some links for SSH clients and how to use it.

If you already have ssh installed on your UNIX-like system, have a user account and password, login may be as easy as typing:

ssh [machine name]

into a terminal window. If your user name on the machine differs from your user name on the local machine, use the -l (lowercase L) option to specify the user name on the machine to which you want to connect. For example:

ssh [machine name] -l [user name]

To use graphical applications (X11) you need to connect with X-forwarding enabled:

ssh [machine name] -l [user name] -Y

If you are connecting from a MS Windows workstation you need to have a X-server program installed (e.g. X-win32) to be able to receive the graphical output.


Files can be transferred securely with scp or sftp. Scp works similar to normal cp. Sftp work similar to normal ftp. Type man sftp for a list of the interactive commands within sftp or man scp for scp examples.

X11 forwarding on Windows

If you need to access SSH with X11 forwarding from the Windows machine, you will need an X11 server for Windows, please check these projects:

LC and LANG errors from the Mac client

To fix LC warnings on Mac, like "can't set the locale; make sure $LC_* and $LANG are correct" you have 2 workarounds.
Note: the changes have to be done on your Mac.

  • Add into your ~/.profile file:
export LANG=en_US.UTF-8
export LC_ALL=en_US.UTF-8


  • Fix /etc/ssh_config, comment out the line "SendEnv LANG LC_*"
Host *
# SendEnv LANG LC_*

please see for details:

Suitable ssh- and sftp clients

Clients for MS Windows

Clients for Macintosh

Clients for JAVA

Links to pages about secure shell