Search…
E.D.D.I Documentation
Getting started
Creating your first Chatbot
Import/Export a Chatbot
Git support
Managed Bots
Deployement management of Chatbots
Extensions
Behavior Rules
Output Configuration
Semantic Parser
Conversations
Passing context information
Output Templating
HttpCalls
HTTP2 and SSL
Facebook Channel Setup
Bot Manager GUI
Docker
RedHat Openshift
Metrics
FAQs
Powered By GitBook
Getting started
Version: ≥4.3.x
Welcome to EDDI!
This article will help you to get started with EDDI.
You have two options to run EDDI, The most convenient way is to run EDDI with Docker. Alternatively, of course, you can run EDDI also from the source by checking out the git repository and build the project with maven using either the mvn command line or an IDE such as eclipse.

Option 1 - EDDI with Docker

There are two ways to use Docker with EDDI, either with docker-compose or launch the container manually.
Prerequisite: You need an up and running Docker environment. (For references, see: https://docs.docker.com/learn/)
  1. 1.
    Checkout the docker-compose file from Github:https://github.com/labsai/EDDI/blob/master/docker-compose.yml​
  2. 2.
    Run Docker Command:
    1
    docker-compose up
    Copied!

Use launch docker containers manually

  1. 1.
    Start a MongoDB instance using the MongoDB Docker image:
    1
    docker run --name mongodb -e MONGODB_DBNAME=eddi -d mongo
    Copied!
  2. 2.
    Start EDDI :
    1
    docker run --name eddi -e "EDDI_ENV=production" --link mongodb:mongodb -p 7070:7070 -d labsai/eddi
    Copied!

Option 2 - Run from Source

Prerequisites:

  • Checkout from Github​
  • Java 11
  • Maven 3
  • MongoDb
  • Download and Install MongoDB (Version >= 3.x)
  • Run MongoDB on default port 27017 (this step is important before you run EDDI):
    mongod --dbpath [ABS_PATH_TO_DATA]

Building Project with Maven

  • Go to the root directory and execute:
    mvn clean install
Important for eclipse users: If you are planning to browse and build EDDI's code from eclipse, you must take in consideration that EDDI uses project Lombok, so you must add it to eclipse classpath, this can be done easily by executing this jar:.m2\repository\org\projectlombok\lombok\1.16.18\lombok-1.16.18.jar

Start Servers locally from Class File

1 - Launch EDDI's ApiServer class with VM options
1
-DEDDI_ENV=[development/production]
Copied!
Example :
1
-DEDDI_ENV=development
Copied!
2 - Set the working directory to apiserver
3 - Go to the browser --> http://localhost:7070​
You can overwrite all configs within EDDI either by altering the configs itself or - for convenience reasons (especially when running as the container) - by passing on VM params.
Example:
1
-DEDDI_ENV=[development/production] **-Dmongodb.hosts=somehost** -Duser.dir=[LOCAL_PATH_TO_EDDI]\apiserver ai.labs.api.ApiServer
Copied!

Start Servers from ZIP

1 - launch EDDI's ApiServer from the packaged ZIP file apiserver/target/apiserver-4.3-package.zip with VM options :
1
-DEDDI_ENV=[development/production] -Duser.dir=[LOCAL_PATH_TO_EDDI]\apiserver ai.labs.api.ApiServer
2
or use .\apiserver\ApiServerStartup.bat resp. ./apiserver/ApiServerStartup.sh
Copied!
2 - Go to Browser --> http://localhost:7070​

Environment Variables

Passing it on to a Docker container (either plain/docker-compose/kubernetes), every environment variable name starting with "EDDI_JAVA_ENV_" will be automatically picked up by EDDI.
Example:
1
EDDI_JAVA_ENV_MONGODB_HOSTS=mongodb.hosts=somehost
Copied!
Would end up as VM param in EDDI
1
-Dmongodb.hosts=somehost
Copied!
Previous
E.D.D.I Documentation
Next
Creating your first Chatbot
Last modified 1yr ago
Export as PDF
Copy link
Contents
Option 1 - EDDI with Docker
Use docker-compose (recommended)
Use launch docker containers manually
Option 2 - Run from Source
Building Project with Maven
Start Servers locally from Class File
Start Servers from ZIP
Environment Variables