# Install temporal with Homebrew, MacPorts, Nix

Command-line interface for running and interacting with Temporal Server and UI. Version 1.8.2 via Homebrew; verified 2026-07-31. Also installable with nix: nix profile install nixpkgs#temporal.

## Install

```sh
sudo av install brew:temporal
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install temporal
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install temporal
```

  Evidence: MacPorts ports tree: devel/temporal/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#temporal
```

  Evidence: nixpkgs package indexes: pkgs/by-name/te/temporal/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:temporal
- **Package manager:** Homebrew
- **Version:** 1.8.2
- **Source summary:** Command-line interface for running and interacting with Temporal Server and UI
- **Homepage:** <https://temporal.io/>
- **Repository:** <https://github.com/temporalio/cli>
- **Last updated:** 2026-07-31T16:46:54Z
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- temporal (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 1.8.2
## Project history and usage

Temporal CLI is the official command-line interface and development server for Temporal. The upstream README describes it as a CLI for running Temporal Server and interacting with Workflows, Activities, Namespaces, and other parts of Temporal.

### Project history

The Temporal CLI repository was created in October 2022 and published a v0.1.0 release in November 2022. It became the modern `temporal` executable for local development, operational commands, and cloud/service interaction.

Temporal itself grew out of the Cadence durable workflow system lineage. Temporal's own blog describes Temporal as a fork of Cadence and the tctl documentation now states that `tctl` is deprecated in favor of Temporal CLI.

### Adoption history

Temporal CLI adoption tracks Temporal's broader developer workflow: local development first, then namespace, workflow, worker, schedule, operator, and cloud-related commands. Official docs recommend transitioning from `tctl` to Temporal CLI for continued support and new features.

Homebrew, MacPorts, and Nix coverage make the CLI easy to install for developers who need a local Temporal development server or day-to-day command access to Temporal services.

### How it is used

The CLI docs emphasize `temporal server start-dev`, which starts a local development Temporal Service for fast feedback. The setup page says this command starts the Web UI, creates the default Namespace, and uses an in-memory SQLite database, with flags for persistence and custom namespaces.

Beyond the development server, the CLI command reference covers commands for workflows, workers, namespaces, configuration, environment handling, and server management.

### Why package nerds care

For package nerds, Temporal CLI is significant because it bundles a serious distributed-systems development loop into a single installable binary. It replaced older CLI workflows around `tctl` and gives Homebrew/Nix users a fast path to `temporal server start-dev` without Docker Compose or a full self-hosted deployment.

### Timeline

- 2020: Temporal blog described Temporal as a fork of Cadence and named early public adopters.
- 2022: Temporal CLI GitHub repository created.
- 2022: v0.1.0 release published.
- 2023: Early v0.x releases continued through the first half of the year.
- 2020s: Official docs deprecated `tctl` and recommended Temporal CLI.

### Related projects

- Temporal CLI relates to Temporal Server, Temporal Web UI, Temporal SDKs, Temporal Cloud, and the deprecated `tctl` utility.
- For local development it partially replaces Docker Compose setup flows; for production it complements self-hosted Temporal deployments and Temporal Cloud administration.

### Sources

- <https://api.github.com/repos/temporalio/cli>
- <https://api.github.com/repos/temporalio/cli/releases>
- <https://docs.temporal.io/cli>
- <https://docs.temporal.io/cli/setup-cli>
- <https://docs.temporal.io/tctl-v1>
- <https://github.com/temporalio/cli#readme>
- <https://temporal.io/blog/workflow-engine-principles>
- source_facts.package-manager


## Security Notes

broad file, network, media, or database tool signal. formula declares a Homebrew service.

- **Geiger risk:** orange / medium
- broad file, network, media, or database tool signal
- formula declares a Homebrew service


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Linux: ~/.config/temporalio/temporal.toml
- macOS: ~/Library/Application Support/temporalio/temporal.toml
- Windows: %AppData%\temporalio\temporal.toml

## Credential files

- Linux: ~/.config/temporalio/temporal.toml
- macOS: ~/Library/Application Support/temporalio/temporal.toml
- Windows: %AppData%\temporalio\temporal.toml
## Other Package-Manager Records

- Nix - temporal: normalized package name match | nixpkgs package indexes: pkgs/by-name/te/temporal/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- MacPorts - temporal: normalized package name match | MacPorts ports tree: devel/temporal/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## Combined YAML source

View the package source record on GitHub. [combined/temporal.yml](https://github.com/mxcl/pkgdb/blob/main/combined/temporal.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph