--- title: General Setup zapHome OnPrem AI Search description: Detailed Information on the general Setup of zapHome OnPrem --- [Skip to content](https://knowledge.zapliance.com/general-setup-zaphome-onprem-ai-search#main-content) English Show submenu for translations [![zapliance logo light bg](https://knowledge.zapliance.com/hubfs/zapliance%20logo%20light%20bg.svg)](https://knowledge.zapliance.com/migration) Open main navigation Close main navigation - English Show submenu for translations - [Contact us](https://zapliance.com/support/) [Contact us](https://zapliance.com/support/) Hi. How can we help? - There are no suggestions because the search field is empty. 1. [Knowledge Base](https://knowledge.zapliance.com/) 2. [Technical Onboarding](https://knowledge.zapliance.com/technical-onboarding) 3. [zapHome](https://knowledge.zapliance.com/technical-onboarding#zaphome) # General Setup zapHome OnPrem AI Search ## Detailed information to prepare for zapHome OnPrem AI Search ### 1. General Information zapHome OnPrem AI Search zapHome OnPrem AI Search is the secure, local technical platform for all zapliance solutions including modern MCP agents. It is designed to analyze SAP data directly within your organization’s IT environment, ensuring maximum data privacy by enabling seamless integration with your own Azure OpenAI services. Controlled outbound connections are used for specific external lookups. All installations are performed on-premise using Docker, so your data remains within your infrastructure. The zapliance agents form an expert team dedicated to SAP data analysis. Specialized agents handle tasks such as SAP data extraction, structured data labeling, and comprehensive risk and opportunity assessments based on the zapliance indicators selected for you. All analysis is conducted exclusively within zapHome and can be flexibly processed further—for example, using Power BI Desktop or through collaboration with other zapliance agents. This can be combined with the targeted use of selected external data sources and services. Additionally, some agents are designed to interact directly with business professionals, understanding your unique business context. Using a chat interface, you can provide instructions to these agents, who independently select and execute the most suitable tools from their toolkit, document the results, and share their insights with you in the chat. While these agents can work together using each other’s outputs, they are also able to function as regular chatbots, leveraging integrated algorithms and targeted web search capabilities to answer your questions. As the customer, you retain full responsibility for the final evaluation of results. With zapHome OnPrem AI Search, you benefit from a secure, customizable, and collaborative environment for advanced SAP data analysis—fully under your control. ![zapHome OnPrem AI Internet 2.0](https://knowledge.zapliance.com/hs-fs/hubfs/KnowledgeBase/zapHome/zapHome%20OnPrem%20AI%20Internet%202.0.png?width=670&height=408&name=zapHome%20OnPrem%20AI%20Internet%202.0.png) --- ### 2. Two-Layer Architecture zapHome OnPrem AI Search is composed of two technically separate layers: - Data extraction (Layer 1) - Data processing (Layer 2) Layer 1 uses SAP RFC connectivity to extract approved SAP data and create governed data copies within the zapAnalytics database. The data scope is defined and approved by the customer. zapAgents cannot independently change the data scope or initiate additional calls. Thus, **all data extractions are defined, approved, and controlled by the customer.** Layer 2 operates exclusively on these extracted data copies. It does not access SAP, does not use RFC, and does not process live SAP data. As a result, SAP access and data processing (including result generation) are technically separated. Analysis is performed on copied data only after extraction has been completed, not on the SAP system itself. For more information, see [SAP Governance Data Extraction with zapliance.](https://knowledge.zapliance.com/sap-governance-data-extraction-with-zapliance) --- ### 3. Components You need to set up the following components to get zapHome alive: #### 3.1 Virtual Machine/Server A Linux-based virtual machine (VM) or server that meets the specified requirements is prepared as the host environment for Docker. Details can be found in the Knowledge Base article: [Setup Guide Virtual Machine / Server](https://knowledge.zapliance.com/vm) We recommend Docker as the container management tool. For other deployment scenarios, [please refer to this article.](https://knowledge.zapliance.com/zaphome-deployment-scenarios) #### **3.2 Docker Setup for zapHome OnPrem AI Search** zapHome OnPrem AI Search is deployed using Docker on the dedicated server or VM. zapliance publishes and manages its images through image registries, ensuring access to the latest verified versions. Details can be found in the Knowledge Base article: [Setup Guide Docker](https://knowledge.zapliance.com/setup-guide-docker-linux) #### **3.3 Docker Containers** Docker containers provide the ability to run applications together with all required components in isolated environments, ensuring consistent and independent operation across systems. ##### **3.3.1 NGINX Reverse Proxy Server** To enable secure browser-based access, all communication between the user's web browser and the containers is routed through a reverse proxy server. It acts as a single gateway, allowing for centrally managed SSL/TLS encryption. Thus, only one certificate is needed to secure the entire environment, simplifying the setup. ##### **3.3.2 zapAnalytics** The zapAnalytics software is provided as a Docker container. Details can be found in the Knowledge Base article: [Setup Guide zapAnalytics](https://knowledge.zapliance.com/setup-guide-zapanalytics-docker-linux) ##### **a) RFC-User Access** zapAnalytics accesses the SAP system for data extraction via RFC using **read-only** permissions, based on the **customer-approved data scope**. Every data extraction is **initiated by an authorized customer user**, either manually or through a customer-configured schedule. zapAnalytics executes the approved extraction scope through **predefined, deterministic RFC logic.** Data extraction via RFC is a separate layer technically independent from subsequent data processing, during with RFC is not utilized or required (See Section 2). Details can be found in the Knowledge Base article: [Setup Guide SAP](https://knowledge.zapliance.com/setup-guide-sap) ##### b) SAP Web GUI During project setup in zapAnalytics, users can specify a SAP Web GUI URL. This allows users to later access individual SAP documents directly from the Power BI Dashboards, without additional effort of searching for the specific item.   Details can be found in the Knowledge Base article: [Setup SAP Web GUI](https://knowledge.zapliance.com/setup-sap-web-gui-url) ##### **c) Content Bundles** A content bundle wraps all analysis logic into a .zip file. After the relevant company codes, fiscal years, and client information are provided, zapliance generates and shares the content bundle (.zip) via an exchange folder in OneDrive. You must upload the content bundle .zip file in zapAnalytics to create a project. Details can be found in the Knowledge Base section: [Content Bundles](https://knowledge.zapliance.com/product-descriptions#content-and-tool-bundles) ##### **d) Parquet Files** After data processing is completed, result files specific to each solution are made available for download. The generated parquet files serve as the foundation for creating Power BI dashboards. Details can be found in the Knowledge Base article: [Setup Guide Power BI Reports](https://knowledge.zapliance.com/setting-up-power-bi-reports) ##### d) MCP Server zapAnalytics can run integrated MCP server for each project to access the results database. Once launched, the MCP server can be connected to the Wilma Agent in LibreChat for further processing and analysis. Details can be found in the Knowledge Base article: [Setup Guide zapAnalytics](https://knowledge.zapliance.com/setup-guide-zapanalytics-docker-linux) ##### f) Selected External Web-Services (e.g. VAT ID Check) zapAnalytics can make use of external web services for automated or manually triggred agent tasks. As an example, an automated check of the registred VAT ID at [official authorities](https://online.portal.bzst.de/EN/Home/home_node.html) can be performed. Thus, zapAnalytics will set up https connections to specific external services. The firewall must allow such a connection. ##### **3.3.3 LibreChat (Chat interface)** LibreChat is provided as a Docker container by zapliance, which means that a separate installation of LibreChat on your target system is not required. Details can be found in the Knowledge Base article: [Setup Guide LibreChat](https://knowledge.zapliance.com/onboarding-librechat) --- ### 4. **Azure OpenAI** The use of Azure OpenAI is required for operating Wilma via LibreChat, as it enables the integration of advanced language models and ensures compliance with enterprise security and data privacy standards. zapHome OnPrem AI Search supports two recommended models: **GPT-5.4** and **GPT-5.6**. The appropriate model depends on your specific use case and requirements. zapliance can provide guidance for your decision-making based on your specific use case. **GPT-5.4** is recommended as the standard model for most use cases, providing a suitable balance between performance and cost. **GPT-5.6** provides stronger capabilities for use cases that require more advanced reasoning but typically results in higher usage costs. Details can be found in the Knowledge Base articles: - [Setup Guide Azure OpenAI](https://knowledge.zapliance.com/microsoft-azure-open-ai-service-for-using-libre-chat) (including Web Search) - [Setup Guide Document Intelligence](https://knowledge.zapliance.com/setup-guide-doc-intelligence) (depending on the solution) --- ### **5. Power BI Desktop** (on End-User Device) Once data extraction and processing are completed within zapAnalytics, the Power BI report templates (.pbit) need to be opened using Power BI Desktop for importing the results from the zapAnalytics result files (.parquet). This will create Power BI reports (.pbix) that are accessible locally by the client, serving as the basis for the workshop session. Details can be found in the Knowledge Base article: [Setup Guide Power BI Reports](https://knowledge.zapliance.com/setting-up-power-bi-reports) --- ##### Additional information Details on data protection, information security and access management can be found[in this section.](https://knowledge.zapliance.com/zaphome#data-protection-information-security) - [Overview Agentic Teams](https://knowledge.zapliance.com/overview-agentic-teams) - [Product Descriptions](https://knowledge.zapliance.com/product-descriptions#main-content) - [Platforms](https://knowledge.zapliance.com/product-descriptions#platforms) - [Agentic Teams](https://knowledge.zapliance.com/product-descriptions#agentic-teams) - [Agentic Team Solutions](https://knowledge.zapliance.com/product-descriptions#agentic-team-solutions) - [Solution Bundles](https://knowledge.zapliance.com/product-descriptions#solution-bundles) - [Customer Success](https://knowledge.zapliance.com/product-descriptions#customer-success) - [Technical Onboarding](https://knowledge.zapliance.com/technical-onboarding#main-content) - [zapHome](https://knowledge.zapliance.com/technical-onboarding#zaphome) - [Virtual Machine/Server](https://knowledge.zapliance.com/technical-onboarding#virtual-machine-server) - [Docker](https://knowledge.zapliance.com/technical-onboarding#docker) - [zapAnalytics Setup Guides](https://knowledge.zapliance.com/technical-onboarding#zapanalytics-setup-guides) - [SAP Setup Guides](https://knowledge.zapliance.com/technical-onboarding#sap-setup-guides) - [LibreChat Setup Guide](https://knowledge.zapliance.com/technical-onboarding#librechat-setup-guide) - [Microsoft Services Setup Guides](https://knowledge.zapliance.com/technical-onboarding#microsoft-services-setup-guides) - [Former Setups](https://knowledge.zapliance.com/technical-onboarding#former-setups) - [Functional Onboarding](https://knowledge.zapliance.com/functional-onboarding#main-content) - [Project Workflows](https://knowledge.zapliance.com/functional-onboarding#project-workflows) - [zapAnalytics User Guides](https://knowledge.zapliance.com/functional-onboarding#zapanalytics-user-guides) - [Wilma User Guides](https://knowledge.zapliance.com/functional-onboarding#wilma-user-guides) - [SAP User Guides](https://knowledge.zapliance.com/functional-onboarding#sap-user-guides) - [Microsoft Services User Guides](https://knowledge.zapliance.com/functional-onboarding#microsoft-services-user-guides) - [Governance Onboarding](https://knowledge.zapliance.com/governance-onboarding#main-content) - [General Governance Information](https://knowledge.zapliance.com/governance-onboarding#general-governance-information) - [Digital Audit Preparation (DAP)](https://knowledge.zapliance.com/governance-onboarding#digital-audit-preparation-dap) - [Cash Recovery AI (CRAI)](https://knowledge.zapliance.com/governance-onboarding#cash-recovery-ai-crai) [![Favikon Color-1](https://knowledge.zapliance.com/hs-fs/hubfs/Favikon%20Color-1.png?width=30&height=30&name=Favikon%20Color-1.png "Favikon Color-1")](https://zapliance.com/) Knowledge Base Copyright © 2026, zapliance GmbH