Skip to content
Snippets Groups Projects
usage.rst 2.87 KiB
Newer Older
Varac's avatar
Varac committed
OAS User panel
--------------

After all the applications are installed, the first thing to do is log into
Varac's avatar
Varac committed
`https://admin.oas.example.org <https://admin.oas.example.org>`__.
This is the "user panel , a place where you can create, edit and delete users.
These users can be used to log into the applications listed below.
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
Varac's avatar
Varac committed
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.

Varac's avatar
Varac committed
For creating users follow the `user creation documentation
<https://docs.openappstack.net/projects/user-panel/en/latest/#creating-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.

Varac's avatar
Varac committed
Links to all available apps are shown in the userpanel dashboard, which can
be used to access these apps without a need to bookmark all URLs.

Varac's avatar
Varac committed
Core applications
-----------------

These applications are available after the installation is completed
successfully:

Grafana
~~~~~~~

`Grafana <https://grafana.com>`__ is a dashboard application that shows you
information about the status of your cluster collected by `Prometheus
Varac's avatar
Varac committed
<https://prometheus.io>`__.

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
Varac's avatar
Varac committed
platform.

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.

RocketChat
~~~~~~~~~~

Varac's avatar
Varac committed
`RocketChat <https://rocket.chat/>`__ is a team chat application.

Wekan
~~~~~
Varac's avatar
Varac committed
`Wekan <https://wekan.github.io>`__ is a Kanban board application.
Varac's avatar
Varac committed
`WordPress <https://wordpress.com>`__ is a website content management system.
Varac's avatar
Varac committed
Click the **Log in** button and then click **Login with OpenID Connect** to use
Varac's avatar
Varac committed
single sign-on.