# 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
- **Package manager page:** <https://formulae.brew.sh/formula/temporal>
- **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>
- **Upstream docs:** <https://temporal.io/>
- **License:** MIT
- **Source archive:** <https://github.com/temporalio/cli/archive/refs/tags/v1.8.2.tar.gz>
- **Last updated:** 2026-07-31T16:46:54Z
- **Generated:** 2026-08-04T22:13:35+00:00

## Executables

- temporal (cli)
- temporal (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Service: declared
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-08-04
- Package-manager version: 1.8.2
- Package-manager updated: 2026-07-31
- Local data: ok
- Upstream repository: https://github.com/temporalio/cli
- Upstream latest detected: v1.8.2 (current)
## 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
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** temporal
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## 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


## Related links

- [Secret-risk packages](https://pkg.so/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://pkg.so/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://pkg.so/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://pkg.so/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [go](https://pkg.so/brew/go/) - Build dependency declared by Homebrew.
- [code-server](https://pkg.so/brew/code-server/) - Shares pkgdb curated category or tags: cli, developer-tools, server.
- [selenium-server](https://pkg.so/brew/selenium-server/) - Shares pkgdb curated category or tags: cli, developer-tools, server.
- [vnu](https://pkg.so/brew/vnu/) - Shares pkgdb curated category or tags: cli, developer-tools, server.
- [pgbouncer](https://pkg.so/brew/pgbouncer/) - Shares pkgdb curated category or tags: cli, developer-tools, server.
- [anycable-go](https://pkg.so/brew/anycable-go/) - Shares pkgdb curated category or tags: cli, developer-tools, server.
- [sqlpage](https://pkg.so/brew/sqlpage/) - Shares pkgdb curated category or tags: cli, developer-tools, server.
- [glassfish](https://pkg.so/brew/glassfish/) - Shares pkgdb curated category or tags: cli, developer-tools, server.
- [atuin-server](https://pkg.so/brew/atuin-server/) - Shares pkgdb curated category or tags: cli, developer-tools, server.
- [brigade-cli](https://pkg.so/brew/brigade-cli/) - Local package facts share a topical domain. Shared terms: cli, command-line, developer, developer-tools, interface.
- [code-cli](https://pkg.so/brew/code-cli/) - Local package facts share a topical domain. Shared terms: cli, command-line, developer, developer-tools, interface.
- [flowrs](https://pkg.so/brew/flowrs/) - Local package facts share a topical domain. Shared terms: cli, developer, developer-tools, orchestration, workflow.

## 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
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- pkgdb category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
