---
title: Setup Guide zapAnalytics with Docker (Linux)
description: zapAnalytics setup with Docker
---

[Skip to content](https://knowledge.zapliance.com/setup-guide-zapanalytics-docker-linux#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. [zapAnalytics Setup Guides](https://knowledge.zapliance.com/technical-onboarding#zapanalytics-setup-guides)

# Setup Guide zapAnalytics with Docker (Linux)

## Detailed guide to prepare the use of zapAnalytics with Docker

### General Information about zapAnalytics

zapAnalytics is a web application based on Java Spring, which uses Apache Tomcat as application server. SAP data extraction is performed via RFC and requires only a reading SAP user authorized with SAP standard function modules. A postgreSQL database is used as the database, where all data is stored locally.

The duration for data extraction and processing can vary significantly depending on the amount of data, and it may take several days. A stable network connection to the ERP and possibly the target system is required to ensure data flow.

The software uses Adoptium Temurin JDK (Java Development Kit). It is "[GNU General Public License, version 2 with the Classpath Exception](https://adoptium.net/docs/faq)" licensed and free of charge.

For secure HTTPS communication [nginx](https://nginx.org/en/) is used as a proxy server gateway between containers and other (internal or external) networks.

### **Requirements**

zapAnalytics, postgreSQL database and nginx are deployed via Docker, running on a virtual machine or server. The hardware specifications depend on the data volume extracted.

- Set up Linux-based virtual machine or server fulfilling minimum requirements: [Setup Guide Virtual Machine / Server](https://knowledge.zapliance.com/vm)
  
    - Make sure that the **required ports for your specific zapHome setup** are allowed through the firewall.
- Prepare and install Docker: [Setup Guide Docker](https://knowledge.zapliance.com/setup-guide-docker-linux)
- Prepare SAP RFC user: [Setup Guide SAP](https://knowledge.zapliance.com/setup-guide-sap)<https://knowledge.zapliance.com/onboarding-sap-admin>
- For end-user devices, please make sure Power BI Desktop is installed so reports can be created: [Setup Guide Power BI](https://knowledge.zapliance.com/setting-up-power-bi-reports)

**Important:** Please make sure that automatic operating system reboots are postponed until intensive data extraction or processing is finished!

Automated reboots during executioncause data loss and unnecessary re-processing.

### Installation Process

zapliance will provide you an access token and a docker-compose.yml file during onboarding. The file includes the default configuration for all containers (inlcuding network and hardware allocation). You can use the standard Docker CLI commands to start, stop and update the zapAnalytics Docker image.

The commands are listed in this Knowledge Base article: [Basic Docker Commands (CLI)](https://knowledge.zapliance.com/basic-docker-commands)

The process can be conducted in a meeting together with zapliance.

**Important:** Select a disk partition with enough disk space and make shure that the running process has read and write access to the folder.

### **Access to zapAnalytics**

Once the software is running, users can access the web interface via https://localhost:9007/zapAnalytics/login on the server.

Client computers in the same internal network can access the web interface via the host's IP address (e.g., https://hostIP:9007/zapAnalytics/login).

The software includes a self-signed certificate (.jks), enabling standard HTTPS communication. You can replace the certificate during onboarding with zapliance by replacing the fullchain.pem and privkey.pem/.key files in the /certs folder.

- [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