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

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 Step 5: Install applications of the installation procedure.

Core applications

These applications are available after the installation is completed successfully:

OAS User panel

The OAS 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 is a dashboard application that shows you information about the status of your cluster collected by Prometheus. 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 is a file sharing and communication platform and is available at https://files.oas.example.org.

Onlyoffice

Onlyoffice 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 is a team chat application and available at https://chat.oas.example.org.

WordPress

WordPress 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.