Usage
=====

After all the applications are installed, the first thing to do is log into
https://admin.oas.example.org. This is the "user panel", a place where
you can create, edit and delete users. You can log in with the user "admin". The
password can be found by running 

.. code:: bash

   python3 -m openappstack oas.example.org secrets

Search for ``userbackend_admin_password``.

After logging in, you will see an overview of all the installed applications
your user has access to. For more information on how to create users and give
them access to applications, take a look at the [user panel
documentation](https://docs.openappstack.net/projects/user-panel/en/latest/).

.. note::

   If you don't see applications, make sure you have installed at least one
   optional application in :ref:`step-5` of the installation procedure.

Core applications
-----------------

These applications are available after the installation is completed
successfully:

OAS User panel
~~~~~~~~~~~~~~

The `OAS user panel <https://open.greenhost.net/openappstack/user-panel/>`__
can be used to create and edit users. These users can be used to log into the
applications listed below.
The user panel is available at https://admin.oas.example.org. You can login
as `admin` using the `userbackend_admin_password` password from your secrets
folder.

After logging in to the user panel follow the [user panel documentation](https://docs.openappstack.net/projects/user-panel/en/latest/#creating-a-new-user)
to create a new user.

*Note*: The email address is important because some applications need a valid
email address for notification mails.
Single sign-on with Grafana will fail for users lacking an email address.

You can now use the new user to log in to all apps which were granted access to
in the last step using single sign-on.

Grafana
~~~~~~~

`Grafana <https://grafana.com>`__ is a dashboard application that shows you
information about the status of your cluster collected by `Prometheus
<https://prometheus.io>`__. Grafana is available at
https://grafana.oas.example.org.

Single sign-on users
''''''''''''''''''''

Users that have the "Admin" label turned on in the user panel, will have admin
rights in Grafana. Other users are able to see graphs, but can not change
anything.

Optional applications
---------------------

Nextcloud
~~~~~~~~~

`Nextcloud <https://nextcloud.com/>`__ is a file sharing and communication
platform and is available at https://files.oas.example.org.

Onlyoffice
~~~~~~~~~~

`Onlyoffice <https://www.onlyoffice.com/connectors-nextcloud.aspx>`__ is an
online document editing suite. Your can open documents in Onlyoffice by clicking
them in Nextcloud. You can open new documents by clicking the "Plus" button in
Nextcloud and selecting Document, Spreadsheet or Presentation.

.. warning::

   OpenAppStack has a known issue that can cause loss of ONLYOFFICE
   documents when the machine gets restarted or loses access to its disk.

   Track the following issue to see if it is solved: https://open.greenhost.net/openappstack/nextcloud/-/issues/967

   We are working hard to resolve the issue.

RocketChat
~~~~~~~~~~

`RocketChat <https://rocket.chat/>`__ is a team chat application and available
at https://chat.oas.example.org.


WordPress
~~~~~~~~~

`WordPress <https://wordpress.com>`__ is a website content management system and
available at https://www.oas.example.org. Click the `Log in` button and then
click `Login with OpenID Connect` to use single sign-on.