Installing the Eggplant AI Server

Eggplant AI is a server application that you install locally so that it can be accessed in a web browser on your local network. These instructions explain how to install Eggplant AI and how to license it. The system requirements for installation are also covered.

System Requirements

Operating Systems:

  • Windows 10
  • Windows Server 2012

Port Availability:

  • 80 or the next available port if port 80 is in use (HTTP Access)
  • 443 (HTTP Access with SSL)

Hardware Requirements:

  • RAM: 8GB minimum
  • Disk Space: 4GB minimum

Supported Browsers:

  • Google Chrome 54 and later
  • Mozilla Firefox 49 and later
  • Safari 11 and later

Installing Eggplant AI

Complete the following steps to install Eggplant AI:

  1. Download the Eggplant AI server installation file from the Eggplant AI Downloads page.
  2. Double-click the downloaded installation file to launch the Setup wizard. Click Next to begin installing Eggplant AI.
  3. On the License Agreement screen, read and accept the License Agreement, then click Next.
  4. On the Installation Directory screen, use the default installation directory (C:\eggplantAI) or use the file browser to select the desired installation directory. Click Next to continue your installation.
    Important: If you change the installation directory from the default selection, the directory name must not contain spaces.
  5. (Optional) If this is a fresh installation, an upgrade from a previous Eggplant AI version, or an upgrade to an Eggplant AI version newer than 2.1, the Existing database screen appears. If you are installing Eggplant AI 2.1 on top of an existing Eggplant AI 2.1 installation, the Existing database dialog box does not appear and the installation continues with the next step.

    Setup dialog box for a fresh Eggplant AI installation

    On the Existing database screen, you might need to enter a path for the current installtion of Eggplant AI. Use the following information to decide whether this step is necessary for your installation:

    • If this is a fresh installation, leave the Existing database field blank.
    • If you are upgrading from a version of Eggplant AI earlier than 2.1, add the path to the application data for the installed version. For example, you might add C:\Program Files\PostgreSQL\9.6\data to the Existing database field.
    • If you are upgrading from Eggplant AI 2.1 to a later version, and plan to use the same directory as the previous version, leave the Existing database field blank.
    • If you are upgrading from Eggplant AI 2.1 to a later version, and plan to use a different directory than the previous version, add the path for the current application data (<install directory>/pgsql/data) to the Existing database field.

    Click Next to continue to the next screen.

  6. On the Ready to Install screen, click Next to continue or Back to return and make changes. If you click Next, the installation begins. The installation step takes some time to complete.
  7. When prompted, set the default HTTP port as follows:
    • If port 80 is available, the installation suggests using port 80. Select Yes to continue or No to make a different selection:

    • If port 80 is not available, you can enter the HTTP port you want to use:

    Note: After you set the HTTP port, the following Eggplant AI services start:
    • PostgreSQL database service: EggplantAIPgServ
    • Ruby service: EggplantAIServ
    • Nginx service: EggplantAIWebServ
  8. Click Finish to complete the installation.

See Licensing AI to open Eggplant AI and manage your Eggplant AI licenses.

Tip: Although Eggplant AI is not supported on Windows 7, the only known problem is a port conflict on port 80 with Microsoft Internet Information Services (IIS), which is installed on Windows by default.

There are two options to resolve this port conflict after installation:

Option 1: Remove IIS or configure it to start manually (rather than having it start automatically).

Option 2: Make the port change for Eggplant AI manually:

  1. Edit the C:\eggplantAI\nginx\conf\nginx.conf file.
  2. Locate the following lines and replace port 80 with an available port:
    server {
    listen 80;
    listen [::]:80;
  3. Save your work.

Initial Login and Licensing

When Eggplant AI is installed and running, you access the application in a browser. On your initial login, you must create an administrator account and enter your license key. Follow these steps to complete your initial login:

  1. Launch your browser from any computer that has access to the Eggplant AI server and enter the appropriate URL:
    • To display the login prompt from the computer on which the Eggplant AI server is running, enter http://localhost.
    • To display the login prompt from a remote computer, enter http://<serverIPaddress> where <serverIPaddress> is the Eggplant AI server's IP address or fully qualified domain name.
    Note: To obtain the IP address of the Eggplant AI server, see your local IT administrator. Distribute the URLs from this step to all users requiring access to this Eggplant AI application.
  2. Eggplant AI prompts you to set up an administrator account. Enter an email address (username) and password for the account.
    On initial log in to Eggplant AI, you create an admin account and enter your license key

    Enter your initial admin credentials and license key for Eggplant AI

    After you configure this administrator account, you can use it to set roles for other users requesting access. See Approving New Users for more information.
  3. Enter a license key. You can generate this in The Greenhouse Licensing Web Portal.
  4. When your information is entered, click OK.

After your account is created, a new login dialog box appears so that you can log in to Eggplant AI.

The Greenhouse Licensing Web Portal

As an Eggplant customer, you have access to the Greenhouse licensing web portal, where you can review and create available license keys as well as download generated licenses for your account.

Note: When you're generating a license key in Greenhouse, render the Host ID with colons and not hyphens, i.e., 0D:D2:22:FA:E7:A7 versus 0D-D2-22-FA-E7-A7.

You can also use this portal to submit questions to support and view information about any support cases.

You should receive your initial Greenhouse login information from your account manager. If you don't have a password, you'll need to contact your account manager or If you need an Eggplant AI license, contact your account manager or Eggplant Support.

Uninstalling Eggplant AI

Use the instructions below if you need to uninstall Eggplant AI.

  1. Select Uninstall eggplantAI from the Start > eggplantAI program group.
  2. Click Yes when prompted if you want to uninstall Eggplant AI and its modules.
  3. Click OK after the removal process is done.

Uninstalling Eggplant AI does leave some folders intact. Note that the data left behind after you uninstall Eggplant AI contains user account information, user models, and execution data. Only remove these files and folders if they are no longer required. Assuming you installed Eggplant AI in the C:/eggplantAI directory, the following folders remain in case you want to retain any files:

  • Nginx web server files: C:/eggplantAI/nginx
  • Eggplant AI data directory files: C:/eggplantAI/pgsql
  • Eggplant AI recovery files: C:/eggplantAI/rollbackBackupDirectory
  • Server and Eggplant AI log files: C:/eggplantAI/www

If you decide that you want to do a complete Eggplant AI removal (after following the above steps to uninstall Eggplant AI), delete the C:/eggplantAI directory.


This topic was last updated on February 14, 2019, at 09:36:17 PM.

Eggplant icon | Documentation Home | User Forums | Support | Copyright © 2019 Eggplant