Technical Documentation

Overview

This section contains technical documentation for the Friendly Tech UI Backend: system composition, deployment options, configuration, health checks, and developer guides.

Installation & Deployment

Page Description

System Components Overview

Architecture, required services and their roles

Installation & Deployment

UI Backend on a dedicated Docker host

AI Agent Service Deployment

AI Agent with PostgreSQL on a separate host

All-in-One Deployment

All UI services on a single Docker host

SSL / HTTPS Configuration

SSL certificate setup for different deployment scenarios

Local Setup without Docker (DEPRECATED)

Running from dist folder without Docker

Custom Font Installation (DEPRECATED)

Adding fonts for PDF export

Post-Installation

Page Description

Health Check & Monitoring

Verifying services are running, log analysis, endpoint checks

Authentication & SSO

Keycloak is the shared identity server for every login type except the built-in database login. Deploy it once, then configure it per login type.

Page Description

Keycloak Deployment

Deploy the Keycloak container: Docker Compose, storage schema, TLS, shared network, HA, and the general interaction architecture

SAML SSO Login

SAML login type: backend variables, IdP certificates, and the Keycloak SAML realm/client/mapper setup (reference guide)

LDAP Login via Keycloak (OIDC)

LDAP login type: backend variables, TLS trust, and the Keycloak OIDC client + LDAP User Federation setup

Azure AD + Keycloak Login

Azure AD login type: Keycloak brokering to Microsoft Entra ID over OIDC

Windows (AD / Kerberos) SSO Setup

Windows login type: silent Kerberos SSO brokered by Keycloak against Active Directory