Run a development server

How to install the Temporal CLI and run a development server

This page describes how to install the Temporal CLI and run a development Temporal Service. The local development Temporal Service comes packaged with the Temporal Web UI.

For information on deploying and running a self-hosted production Temporal Service, see the Self-hosted guide, or sign up for Temporal Cloud and let us run your production Temporal Service for you.

Temporal CLI is a tool for interacting with a Temporal Service from the command line and it includes a distribution of the Temporal Server and Web UI. This local development Temporal Service runs as a single process with zero runtime dependencies and it supports persistence to disk and in-memory mode through SQLite.

Install the Temporal CLI

The Temporal CLI is available on macOS, Windows, and Linux.

macOS

How to install the Temporal CLI on macOS

Choose one of the following install methods to install the Temporal CLI on macOS:

Install the Temporal CLI with Homebrew

brew install temporal

Install the Temporal CLI from CDN

1. Select the platform and architecture needed.

• Download for Darwin amd64: https://temporal.download/cli/archive/latest?platform=darwin&arch=amd64
• Download for Darwin arm64: https://temporal.download/cli/archive/latest?platform=darwin&arch=arm64

2. Extract the downloaded archive.

3. Add the temporal binary to your PATH.

Linux

How to install the Temporal CLI on Linux

Choose one of the following install methods to install the Temporal CLI on Linux:

Install the Temporal CLI with Homebrew

brew install temporal

Install the Temporal CLI from CDN

1. Select the platform and architecture needed.

• Download for Linux amd64: https://temporal.download/cli/archive/latest?platform=linux&arch=amd64
• Download for Linux arm64: https://temporal.download/cli/archive/latest?platform=linux&arch=arm64

2. Extract the downloaded archive.

3. Add the temporal binary to your PATH.

Windows

How to install the Temporal CLI on Windows

Follow these instructions to install the Temporal CLI on Windows:

Install the Temporal CLI from CDN

1. Select the platform and architecture needed and download the binary.

• Download for Windows amd64: https://temporal.download/cli/archive/latest?platform=windows&arch=amd64
• Download for Windows arm64: https://temporal.download/cli/archive/latest?platform=windows&arch=arm64

2. Extract the downloaded archive.

3. Add the temporal.exe binary to your PATH.

Start the Temporal Development Server

Start the Temporal Development Server by using the server start-dev command.

temporal server start-dev

This command automatically starts the Web UI, creates the default Namespace, and uses an in-memory database.

The Temporal Server should be available on localhost:7233 and the Temporal Web UI should be accessible at http://localhost:8233.

The server's startup configuration can be customized using command line options. For a full list of options, run:

temporal server start-dev --help