.. _tutorials-onboarding-m1-connecting:

Connecting to CoSTAR
=======================

Your account should have been enabled for cluster login.

Command-Line Access
-------------------

Prerequisites:

* A terminal application such as ``xterm``, ``iTerm``, ...
* :ref:`GlobalProtect VPN<start-login-vpn>` if you are off campus and not using the SSH gateway

When on campus, connected to the VPN, or logged into the SSH gateway connect via:

.. code-block:: bash

   ssh <your_username>@costar-login01.surrey.ac.uk

Once logged in, try:

.. code-block:: bash

   echo "Hello, World"
   hostname

Browser Access
--------------

CoSTAR also provides Open OnDemand for browser-based access to files, shells, Jupyter, and interactive applications:

* `CoSTAR Open OnDemand <https://costar-ood.surrey.ac.uk/>`__
* `Open OnDemand step-by-step guide <https://surreyac.sharepoint.com/sites/SurreyResearchComputing/SitePages/OpenOnDemand.aspx>`__

Off-Campus Access
-----------------

* `University remote access information <https://www.surrey.ac.uk/information-university-surrey-staff#remote>`__
* `Research Computing login documentation <https://docs.pages.surrey.ac.uk/research_computing/gettingstarted/login.html>`__

File Transfer
-------------

Use an SFTP-capable client or command-line tools such as ``scp``, ``sftp``, or ``rsync`` depending on the workflow.


Next Steps
----------

.. grid:: 1 2 2 2
   :gutter: 3
   :margin: 1

   .. grid-item-card:: :octicon:`code` 1.4 Linux Basics
      :link: tutorials-onboarding-m1-linux-commands
      :link-type: ref
      :class-card: sd-outline-info

      A cheat sheet of essential terminal commands required for navigating an HPC environment.

   .. grid-item-card:: :octicon:`checklist` 1.5 Self-Check Quiz
      :link: tutorials-onboarding-m1-quiz
      :link-type: ref
      :class-card: sd-outline-success

      Test your understanding of the introductory material before moving to Module 2.