LEIP Enterprise provides a web application to analyze and graph metrics from all your LEIP experiments. For this to happen, you need to deploy the application either on-premise or on the cloud, and connect to it from the LEIP SDK container.
On-premise Server Setup
Your license key and access to the Latent AI container registry. You may contact firstname.lastname@example.org for assistance.
We recommend that you have at least 4 GB of RAM available to Docker.
Download the following file to a directory called
leip-enterprise on your computer:
To configure and start the server, run
python3 run.py start. This will interactively ask you some details to generate the configuration files:
.env. Then it will automatically start the server.
If you also want to include the Kibana service, you may do so by running
python3 run.py start --kibana.
Here’s an example run:
% cd leip-enterprise
% python run.py start
***** Latent AI, Inc.
***** LEIP Enterprise lifecycle script
Docker version 20.10.13, build a224086
Docker Compose version v2.3.3
Do you want to include sample data (50 experiments)?
(yes/no) [Default: no]: yes
Do you wish to configure the SMTP service for sending emails?
This is used to send account info to all LEIP Enterprise users, but it is optional.
(yes/no) [Default no]: yes
SMTP TLS (yes/no) [Default: no]: yes
SMTP Host: smtp.gmail.com
SMTP Port: 587
SMTP User: email@example.com
SMTP Password: smtp-password
[+] Running 4/4
⠿ db Pulled 1.5s
⠿ elasticsearch Pulled 1.7s
⠿ frontend Pulled 2.2s
⠿ backend Pulled 2.2s
[+] Running 7/7
⠿ Network leip-enterprise_net Created 0.0s
⠿ Volume "leip-enterprise_app-db-data" Created 0.0s
⠿ Volume "leip-enterprise_elasticsearch" Created 0.0s
⠿ Container leip-enterprise-elasticsearch-1 Started 0.7s
⠿ Container leip-enterprise-db-1 Started 0.6s
⠿ Container leip-enterprise-backend-1 Started 1.0s
⠿ Container leip-enterprise-frontend-1 Started 1.5s
Successfully started LEIP Enterprise Server
You can access it at http://localhost
LEIP Enterprise will keep running on the background, and will restart automatically if a service ever fails.
You may configure it yourself with 'docker-compose'
The script output will include your administrator account details for the LEIP Enterprise UI, and the optional account for the Kibana UI. After about 30 seconds, all services should be ready, and the locally deployed application will be available at http://localhost.
When you need to stop the services, run:
python3 run.py stop
If you want to clear the current configuration to start over, run:
python3 run.py clear
You may open the LEIP Enterprise UI at http://localhost and login with your configured administrator account from the output of the run script.
If you accepted the inclusion of sample data, you can visualize those already.
Before you configure your LEIP SDK container to send events to LEIP Enterprise, you may want to add a new user, a project, and permissions between them, so that you can associate events with that user and project. To create them, use the configuration button on the top right and click “Configure users” and/or “Configure projects”.
LEIP SDK Container Setup
To easily connect your LEIP SDK container to LEIP Enterprise, determine the name or hash of your running SDK container (usually
leip) and then run this (outside of the container):
docker network connect leip-enterprise_net leip
And then, switch back to the SDK container and configure LEIP Enterprise by running:
leip enterprise init
Here you will set these values:
admin(or any user you previously set in LEIP Enterprise UI).
Password: the password for
admin, indicated in the output of the start command, or the password set by you in the LEIP Enterprise UI.
Project: Select a project from the list (if you created one and gave the user permission) or just select
You may change any of these values at any time using individual commands (See
leip enterprise --help for details).
After the LEIP Enterprise server is up and a LEIP SDK container is configured, you may run any LEIP commands on the LEIP SDK container as usual and will be able to visualize metrics data on the LEIP Enterprise application.