.. _login:

Logging Into The AIBS Karabo Interface
======================================

The AIBS Karabo configuration interface is accessible via a special
display node, to which only certain users have access.

To log onto this node, go to the address communicated to you in a web browser.
This will open a FastX webinterface. You will see a login page, where you need
to give your standard XFEL computing credentials.

.. image:: media/fastx_login.png


After logging in you will see the session select screen of FastX.
If you've previously logged in you can select your already running session
here, if its your first log in, click launch session, then select `XFCE` and
click `Launch`.

.. image:: media/fastx_session_screen.png


If you've started a new session, you will see a page open up with an empty
desktop environment, similar to the one below.


.. image:: media/fastx_empty.png


In case you launched your previous session, your Desktop will already contain
the applications you've last used.

Starting the Karabo GUI in FastX and Connecting to the AIBS
===========================================================

On the Desktop, select `Applications` in the top left corner and open a
`Terminal Emulator`

.. image:: media/fastx_terminal.png


In the terminal that opens type the following command:

.. code-block:: bash

    module load exfel karabo-gui
    karabo-gui


This will launch a Karabo-GUI. In the login information, select `expert`
as user and enter the special port number (available from Z. Ansari upon
request). Then click "connect".

You are now logged into the AIBS Karabo interface.