Running via Docker (local development)
You can use the Docker image
camunda/tasklist:latest to run Tasklist as a container.
Configure the appropriate settings described in the configuration section of this deployment guide.
See the following example of configuration for
Manual configuration (local development)
Here, we’ll walk you through how to download and run a Tasklist distribution manually, without using Docker.
The Tasklist web UI is available by default at http://localhost:8080. Ensure this port is available.
Download Tasklist and a compatible version of Zeebe
Tasklist and Zeebe distributions are available for download on the same release page.
Each version of Tasklist is compatible with a specific version of Zeebe.
On the Zeebe release page, compatible versions of Zeebe and Tasklist are grouped together. Ensure you download and use compatible versions. This is handled for you if you use the Docker profile from our repository.
Tasklist uses open-source Elasticsearch as its underlying data store. Therefore to run Tasklist, download and run Elasticsearch.
Tasklist is currently compatible with Elasticsearch 7.16.2. Download Elasticsearch here.
To run Elasticsearch, execute the following commands in Terminal or another command line tool of your choice:
You’ll know Elasticsearch has started successfully when you see a message similar to the following:
[INFO ][o.e.l.LicenseService ] [-IbqP-o] license [72038058-e8ae-4c71-81a1-e9727f2b81c7] mode [basic] - valid
To run Zeebe with Elasticsearch Exporter, execute the following commands:
You’ll know Zeebe has started successfully when you see a message similar to the following:
[partition-0] [0.0.0.0:26501-zb-actors-0] INFO io.camunda.zeebe.raft - Joined raft in term 0
[exporter] [0.0.0.0:26501-zb-actors-1] INFO io.camunda.zeebe.broker.exporter.elasticsearch - Exporter opened
To run Tasklist, execute the following commands:
You’ll know Tasklist has started successfully when you see messages similar to the following:
2020-12-09 13:31:41.437 INFO 45899 --- [ main] i.z.t.ImportModuleConfiguration : Starting module: importer
2020-12-09 13:31:41.438 INFO 45899 --- [ main] i.z.t.ArchiverModuleConfiguration : Starting module: archiver
2020-12-09 13:31:41.555 INFO 45899 --- [ main] i.z.t.w.StartupBean : Tasklist Version: 1.0.0
Access the Tasklist web interface
The Tasklist web interface is available at http://localhost:8080.
The first screen you'll see is a sign-in page. Use the credentials
demo to sign in.
If you've already developed user tasks in Zeebe, you can see these on the left panel on the start screen: