Skip to main content

Quick install Temporal Server for testing and local development

Overview#

There are two ways to quickly install and run the Temporal Server:

  • Docker: Using docker-compose makes it easy to develop Workflows locally.
  • Helm Charts: Deploying the Server to Kubernetes is an easy way to test the system and develop Workflows.

We do not recommend using either of these methods in a live (production) environment.

Helm Charts#

Instructions for using the Temporal Helm Chart is available in the temporalio/helm-charts repo README.

Docker#

Prerequisites#

  1. Install Docker
  2. Install docker-compose

Run the Temporal Server#

The following steps will run a local instance of the Temporal Server using the default configuration file:

  1. Clone the temporalio/docker-compose repository.
  2. Change directory into the root of the project.
  3. Run the docker-compose up command.
git clone https://github.com/temporalio/docker-compose.git
cd docker-compose
docker-compose up

After the Temporal Server has started you can view the Temporal Web interface in your browser: localhost:8088

Alternative configurations#

If you want to try other configurations using different dependencies (e.g. different database), or use a custom Docker image, follow the temporalio/docker-compose README.

Run application Workflows#

You can now write and run Workflows via the Temporal Server.

Get started quickly by running a Go sample, Java sample, or write your own using one of the SDKs.