Skip to main content

How to quickly install the Temporal Server for testing and local development

Use docker-compose to quickly install and run the Temporal Server locally to test the system while developing Workflows.

Make sure both Docker and docker-compose are installed.

Then clone the temporalio/docker-compose repository and run docker-compose up from the root of that repo:

git clone
cd docker-compose
docker-compose up

When the Temporal Server is running, Workflow Executions can be invoked. The Temporal Server can be kept running in the background while applications are built. Workflow Execution details can be viewed in the Temporal Web UI via your browser: localhost:8088.

The preceding steps start the Temporal Server using a default configuration.

To try other configurations (different dependencies and databases), or to try a custom Docker image follow the temporalio/docker-compose README.

Get notified of updates