.. _sftp:

Using SSH or SFTP [Deprecated]
==============================

.. warning:: Users are encouraged to use the other data access mechanism using S3 protocol. 

The easiest way to access your home directory and data remotely is using either SSH access or SFTP.
The connection details are:

* **File protocol:** SSH or SFTP 
* **Host name:** imaxtgw.ast.cam.ac.uk
* **Username:** *You archive username*
* **Password:** *Your archive password*

From the commnad line you can connect then using either of the following commands (replacing *username* with 
your archive username).

.. code-block:: bash

    # For SSH
    ssh username@imaxtgw.ast.cam.ac.uk

    # For SFTP
    sftp username@imaxtgw.ast.cam.ac.uk

This will prompt for your password and on successful authentication present you with a prompt.
The default location on the remote server is your home directory (``/home/username``). This is 
the same as the home directory in your Notebook instance so you would have access to all
your notebooks and scripts.

In order to upload data, use the directory ``/storage/username``.

Useful commands when using sftp are:

* **pwd** shows the current location on the remote server
* **cd /storage/username** changes the remote location to ``/storage/username``
* **ls** lists the contents of the remote directory
* **get** download file
* **put** upload file
* **put -r localdir** upload a directory
* **help** print a list of commands 
* **quit** quit sftp

You can also transfer data using SCP, e.g.:

.. code-block:: bash

    scp *.tiff username@imaxtgw.ast.cam.ac.uk:/storage/username/images/