.. _gen_control_login:

Logging onto exflgateway
========================

Most detector control and online calibration will require you to work from a host within the control network.
This procedure describes how to log into exflgateway. From there you can access control network hosts if you
have the correct privileges.

.. note::

   Your account has to be registered to access the control network. You can do this by filling out this form_, and
   obtaining the relevant signatures


1. if not using a DESY VPN connection, log on to bastion.desy.de if you need X forwarding:

   .. code-block:: console

       ssh -X username@bastion.desy.de

   For using port forwarding with a Jupyter notebook

   .. code-block:: console

       ssh -L XXXX:localhost:XXXX username@bastion.desy.de

   where you replace `XXXX` with a port number, e.g. 7999.


.. note::

    Use `ssh -Y` on MacOs computers.


2. log on to `exflgateway`; you can do this directly when using a VPN connection:

   .. code-block:: console

       ssh -X exflgateway

   or for port forwarding

   .. code-block:: console

       ssh -L XXXX:localhost:XXXX exflgateway

   be sure to use the same port as before.


.. _form: https://docs.xfel.eu/share/page/site/daqControls/document-details?nodeRef=workspace://SpacesStore/b34e75d5-3e0f-4097-9264-74f3db208845