Docs‎ > ‎Espresso Appliance‎ > ‎

Running Espresso as a Docker image

Docker is a powerful virtualization technology that makes it easy to start minimal images instead of a full-blown virtual machine.

You can run Espresso Logic on your own machine in just a few minutes, with very little effort. This page explains how.

Make sure Docker is installed

On Linux

If you are on a Linux machine, you can try the command line:

$ docker
Usage: docker [OPTIONS] COMMAND [arg...]

If you get an error (e.g. "command not found"), you'll need to install Docker.

On Windows or Mac

If you are on a Windows or Mac machine, you will need Boot2Docker. If you don't have Boot2Docker installed:

Install the Espresso Logic images

From the command line (on Linux) or the Boot2Docker command line (Windows/Mac):

Install the MySQL image that contains the repository and the demo database:
docker run -p 33306:3306 --name espresso-admin -d espressologic/admindb:v5 mysqld --user=mysql

Install the Tomcat image that contains the service and the apps:
docker run --name espresso -d -p 80:8080 --link espresso-admin:espresso_admin espressologic/service:v4 bin/ run

Note that this will attempt to use port 80 on your Docker machine -- if that's a problem, you can substitute a different port.

At this point, your Espresso Logic service should be up. To verify, open your favorite browser and point it to:

  • on Linux, http://localhost/LogicDesigner

  • on Windows and Mac, find the IP address of your Docker host. In your Boot2Docker terminal window, you'll see something like:

To connect the Docker client to the Docker daemon, please set:

    export DOCKER_HOST=tcp://

That address ( in this case) is the address of your Docker host. Connect your browser to:

To log into the Logic Designer, use user name admin and password EspressoAdmin

The espresso-admin image runs a copy of MySQL. If you want to connect to it, the MySQL user name is espresso_admin with password EspressoSql2014 -- please note that MySQL is exposed on port 33306 of the container (not the usual port 3306).

Are we done yet?

At this point, your service is up -- please see the Logic Designer tutorial if you prefer to use a GUI. If you prefer the command line, read on.

Make sure Node.js is installed and running

From a command line, you should be able to run:

$ node

If you get an error message (e.g. command not found), then you need to install Node before continuing.

Install the Espresso Logic admin CLI

From the command line, run:

npm install -g espresso-admin-cli  (on Mac and Linux, you want to run sudo npm install -g espresso-admin-cli )

Windows note: Npm will create a new command called espressoadmin in your node_modules/.bin directory. If this directory is not in your path, you may want to make it so, otherwise you'll have to specify the whole path to the command.

At this point, you should be able to run the following command from a command line:

$ espressoadmin
You must specify a command

  Usage: espressoadmin [options] [command]

If you get an error message like command not found, then you'll need to make sure that npm's bin directory is in your path (see Windows note above if you are running Windows).