.. _sshclient:

.. index::
   single: ssh


==================
command-line login
==================

The secure shell (SSH) client provides a text-based interface to execute commands on the remote machine. 

.. warning::

    Do not log into multiple servers simultaneously. Log into the same server where you already have jobs (e.g. X2Go session) running.


.. _sshclient_mac:

--------------------------------------------------------------------------------------------------------------------------------
secure shell (ssh) on Mac and Linux
--------------------------------------------------------------------------------------------------------------------------------

#. Enable :ref:`mfa`

#. Open a terminal window.

#. At the commmand prompt, run the 'ssh' command (replace <username> with your login username)::

        ssh <username>@nx1.neuro.berkeley.edu

#. You will be prompted for your login password and a 'verification code' at login, e.g.::

        $ ssh me@nx2.neuro.berkeley.edu
        Password:
        Verification code:


.. _sshclient_windows:

--------------------------------------------------------------------------------------------------------------------------------
secure shell on Windows
--------------------------------------------------------------------------------------------------------------------------------

#. Enable :ref:`mfa`

#. download secure shell client from `UC Software Central <http://software-central.berkeley.edu/>`_, or from `PuTTY <http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html>`_.

#. configure the server name, e.g. 'nx1.neuro.berkeley.edu'

#. You will be prompted for your username, login password, and verification code.