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:

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 name for the first and default context in OX App Suite.

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 name 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>"
```

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"

OX App Suite packaged integration for Nubus for Kubernetes

Install packaged integration

3. Install packaged integration#