Skip to main content

Set up a local development environment for Temporal and Go

To follow the Go SDK tutorials we recommend that you have the following environments set up.

Install Go

Make sure you have Go installed. These tutorials were produced using Go 1.18.

Next, you'll configure a local Temporal cluster for development.

Set up a Temporal development cluster

Download and install the Temporal development cluster locally using Docker Compose. You'll run this server in the background while you develop your applications.

You must have Docker and Docker Compose installed.

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

git clone

Switch to the directory:

cd docker-compose

Then run docker compose to download the various container images and start the development cluster:

docker-compose up

When the Temporal Cluster is running, the Temporal Web UI becomes available in your browser. Visit localhost:8080

Review other methods in the Run a dev Cluster section in Temporal's documentation.

Once you have everything installed, you're ready to build apps with Temporal on your local machine.