Docker

The Elsa project currently offers three different Docker images:

• Elsa Server + Studio

• Elsa Server

• Elsa Studio

These images make it easy to give Elsa a quick spin without first creating an ASP.NET application and setting up Elsa. Before trying to run an image, make sure you have Docker installed on your machine.

Elsa Server + Studio

This image hosts an ASP.NET Core application that runs both as an Elsa Server as well as an Elsa Studio application. To run the container, simply run the following commands from your terminal:

docker pull elsaworkflows/elsa-server-and-studio-v3-3-0-preview:latest
docker run -t -i -e ASPNETCORE_ENVIRONMENT='Development' -e HTTP_PORTS=8080 -e HTTP__BASEURL=http://localhost:13000 -p 13000:8080 elsaworkflows/elsa-server-and-studio-v3:latest

When the container has started, open a web browser and navigate to http://localhost:13000. On the login screen, enter the following credentials:

username: admin
password: password

Elsa Server

This image hosts an ASP.NET Core application that runs as an Elsa Server. To run the container, simply run the following commands from your terminal:

docker pull elsaworkflows/elsa-server-v3-3-0-preview:latest
docker run -t -i -e ASPNETCORE_ENVIRONMENT=Development -e HTTP_PORTS=8080 -e HTTP__BASEURL=http://localhost:13000 -p 13000:8080 elsaworkflows/elsa-server-v3:latest

When the container has started, open a web browser and navigate to http://localhost:13000.

To view the API endpoints, navigate to http://localhost:13000/swagger.

Elsa Studio

This image hosts an ASP.NET Core application that runs Elsa Studio. To run the container, simply run the following commands from your terminal:

docker pull elsaworkflows/elsa-studio-v3-3-0-preview:latest
docker run -t -i -e ASPNETCORE_ENVIRONMENT='Development' -e HTTP_PORTS=8080 -e ELSASERVER__URL=http://localhost:13000/elsa/api -p 14000:8080 elsaworkflows/elsa-studio-v3:latest

Requires Elsa Server

Note that Elsa Studio needs to connect to an existing Elsa Server instance, which URL is configured via the ELSASERVER__URL environment variable passed to the container (on port 13000 in this example). To quickly start an Elsa Server instance, you can run the Elsa Server Docker image as outlined in the previous chapter.

When the container has started, open a web browser and navigate to http://localhost:14000. On the login screen, enter the following credentials:

username: admin
password: password