Skip to main content

ADF Installation and Upgrade Guide

13/07/2026

This guide summarizes the installation and upgrade procedures for the Application Development Framework (ADF).

The ADF Search Application is built within the ADF. It is a low-code development platform that provides an architectural basis for fully programmed and customizable frontends, workbenches, and dashboards. The ADF Search Application is a separate out-of-box solution built on the ADF that uses a knowledge graph to provide intelligent semantic search capabilities. It encompasses several features, such as:

  • searching for documents

  • highlighting extracted concepts from documents

  • expanding found concepts using inference tagging

  • recommending relevant documents

Starting with version 1.8.1, ADF is deployed using a fully cloud-native approach via Helm charts on Kubernetes. The previous installation method using download scripts and standalone WAR files has been replaced by a dockerized, Helm-managed deployment.

Important

Starting with Semantic Workbench 2.5.0 and ADF 1.9.0, the single KEYCLOAK_URL variable is deprecated and now maps exclusively to internal traffic.

To resolve past OAuth redirect issues, Keycloak network traffic has been split. The following variables can now be used instead:

  • KEYCLOAK_PUBLIC_URL: Used for browser-facing actions (authorization, issuer, logout).

  • KEYCLOAK_INTERNAL_URL: Used for back-channel service communication (tokens, JWKS validation).

Details can be found in the addons.yaml and .env_template files in the compose-files repository.

In this section: