Docker

The Elsa project currently offers three different Docker images:

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: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
        

That's it!

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: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.

That's it!

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: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
        

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
        

That's it!

Last modified: 25 January 2024