Skip to main content
Skip table of contents

Quick Start Setup

This guide will walk you through setting up a small Germain UX environment, suitable for testing. Please note that this configuration is not recommended for production environments.

Hardware Requirements

  • CPU with at least 4 cores

  • 32 GB of RAM

  • 100 GB of disk space

Software Requirements

  • Docker

  • Docker-compose

Installation

  1. Download and extract the Germain UX package

    CODE
    cd /opt
    wget https://germain-apm.s3.us-west-2.amazonaws.com/GermainAPM/2024/germainux-quickstart-2024.2-binary.tar.gz
    tar xzf germainux-quickstart-2024.2-binary.tar.gz

  2. Deploy your license key

    CODE
    cd germainux
    echo <your license key> > config/license.key

    Example:

  3. Deploy client distribution files (optional)

    CODE
    wget https://germain-apm.s3.us-west-2.amazonaws.com/GermainAPM/2024/GermainAPMEngine-2024.2-8-binary.zip
    unzip GermainAPMEngine-2024.2-8-binary.zip -d data/server/dist/2024.2

  4. Update email settings (optional)
    Update the email settings in the included common.properties file to match your SMTP server:

  5. Start containers

    CODE
    docker-compose -f germainux.yaml up -d --force-recreate

    This will start up the containers necessary to run Germain UX and create the default schemas and OOTB config. The individual containers will generate log output under the data directory.

    This process will take a few minutes to complete - you should see the system CPU utilization spike and the drop once the services had completed their startup.

  6. Verify that all containers are running:

    CODE
    docker ps

  7. Connect to the Germain UX workspace
    By default, the workspace can be accessed via http://<your ip>:8080/germainapm/workspace/ using the default credentials (admin / admin):

    Login Page - Germain UX Workspace

  8. Stop containers

    CODE
    docker-compose -f germainux.yaml down

Service: Enterprise

Feature Availability: 2024.1

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.