3. Install packaged integration

This section describes how an operator installs the packaged integration for OX App Suite to Nubus for Kubernetes. The packaged integration for OX App Suite installs the following customizations to Nubus:

• A tile in the Nubus Portal that links to the OX App Suite instance.

• Management capability in the Management UI for the following objects of OX App Suite:

  • Access profile

  • Functional accounts

  • OX Context

  • OX Resources

  • Select user accounts in Nubus for access to OX App Suite

  • Organize users in groups

For more information about loading packaged integrations, see Load packaged integrations in Univention Nubus for Kubernetes - Nubus Customization and Modification Manual [1].

Before you begin, you need to the location and name of the container image from the software developer, or responsible entity of the packaged integration. The example uses the following values:

Registry:

artifacts.software-univention.de

Repository:

nubus/images/ox-extension

To install the packaged integration to your Nubus for Kubernetes installation, use the following steps:

1. Add the content from nubus-values.yaml to the custom_values.yaml values file of your Nubus for Kubernetes installation. Listing 3.1 shows the Helm Chart values of that file. You must define values for the following variables here:

   oxDefaultContext

   You must define the number of the context as integer value, for the first and default context in OX App Suite. You can define the value as number, for example 10, or as string, for example "10".

   oxSystemUserPassword

   You can pick any secure password and use it later to set up LDAP in Open-Xchange.

   portalOxLinkBase

   It’s the URL to your OX App Suite instance. You have it after you installed OX App Suite. See Install OX App Suite.

   To pick an appropriate version number for the packaged integration in the tag attribute, see the tags and the changelog in the repository.

   Listing 3.1 Helm Chart values for adding the Open-Xchange packaged integration

   # SPDX-License-Identifier: AGPL-3.0-only
   # SPDX-FileCopyrightText: 2025 Univention GmbH
   
   global:
     extensions:
       - name: "ox"
         image:
           registry: "artifacts.software-univention.de"
           repository: "nubus/images/ox-extension"
           tag: "0.22.0"
           imagePullPolicy: "IfNotPresent"
   
   nubusStackDataUms:
     templateContext:
       oxDefaultContext: "<The number of the first and default context in OX App Suite>"
       oxSystemUserPassword: "<Password for the LDAP search user>"
       portalOxLinkBase: "<Base URL to your OX App Suite instance>"
   

2. To apply the changes to your Nubus for Kubernetes installation, run the commands in Listing 3.2

   Listing 3.2 Install the Open-Xchange packaged integration

   $ export NAMESPACE_FOR_NUBUS="Set to your Kubernetes namespace"
   $ export RELEASE_NAME="The Helm Chart release name"
   $ export VERSION="Your version of Nubus"
   $ helm upgrade \
      "$RELEASE_NAME" \
      --namespace="$NAMESPACE_FOR_NUBUS" \
      oci://artifacts.software-univention.de/nubus/charts/nubus \
      --values custom_values.yaml \
      --version "$VERSION"