⚠️ This document is for the Alpha version of Nubus for Kubernetes. Feedback is welcome. ⚠️

4. Getting started#

This section provides the basic information you need to get started with Nubus on a Kubernetes cluster. With this information, you can sign in to the Nubus system and start using it.

To follow along, you first need to complete the steps in Installation.

4.1. Provided users#

The default Nubus installation provides the following users:

default.admin

This user has the role admin with full control over the Nubus system. The administrator can create and manage users, groups, and permissions, and configure the system settings.

default.user

This user has the role user, which can access the installed Nubus components, and edit its profile.

Administrator

This user has role the admin and user, which can manage the Nubus system and access all the available applications.

To get the password for the default administrator, use the following command:

Listing 4.1 Get passwords for default users#
$ export YOUR_NAMESPACE="Set to your Kubernetes namespace"

$ kubectl -n  "$YOUR_NAMESPACE" get secret nubus-nubus-credentials \
   -o json | jq -r '.data.admin_password' | \
   base64 -d

Similarly, you can also get the default user password by running:

$ kubectl -n  "$YOUR_NAMESPACE" get secret nubus-nubus-credentials \
   -o json | jq -r '.data.user_password' | \
   base64 -d

4.2. Open the Portal#

The Portal is the central entry point to Nubus for Kubernetes. Open your web browser and access the Portal under the following URL: https://portal.{global.domain}/. The value in global.domain completes the FQDN of the URL.

Example:

https://portal.nubus.example.com/, where nubus.example.com is the value in global.domain.

4.3. Rendered template#

To look up the final values of the configuration and for reference purposes of the Helm Chart used for your deployment, you can use Helm to render the template as shown in Listing 4.2.

Listing 4.2 Use Helm to render the Helm Chart template#
$ helm template \
   --values custom_values.yaml \
   --version "$VERSION" \
   oci://artifacts.software-univention.de/nubus/charts/nubus