Skip to main content

Use with Temporal Cloud

The Temporal CLI works with Temporal Cloud. The same commands you use for local or self-hosted Temporal services, such as temporal workflow start and temporal workflow list, work with Temporal Cloud as allowed by your role once you provide an address and credentials.

For administrative tasks, install the Temporal Cloud extension. The extension adds temporal cloud commands for managing your Temporal Cloud account, including Namespaces, users, API keys, and Nexus endpoints.

Support, stability, and dependency info

The Temporal Cloud extension is in Pre-release. APIs and configuration may change before the stable release.

Access to Temporal Cloud is governed by role-based access control (RBAC). Your ability to perform actions, including running CLI commands against in Temporal Cloud is determined by the roles and permissions you have been assigned. Refer to the Access control page for more details.

Connect to Temporal Cloud​

To connect the CLI to Temporal Cloud, provide the Temporal service address, Namespace name, and credentials. Temporal Cloud supports three credential types: OAuth tokens obtained through the temporal cloud login interactive login command, API keys, and mTLS certificates.

Interactive login​

The temporal cloud login command opens a browser to authenticate with Temporal Cloud using OAuth. Provide a profile name to store credentials in. If no profile is specified, credentials are stored in the default profile.

temporal cloud login --profile prod

Complete the interactive login process in your browser. After login, your OAuth token is stored in the specified configuration profile. Run commands against Temporal Cloud by specifying the profile, address, and Namespace:

temporal workflow list --profile prod  \
  --address <address>\
  --namespace <namespace>

Non-interactive login​

For AI agents, CI pipelines, scripts, and other non-interactive environments, use API keys or mTLS certificates. Store credentials in a configuration profile or set them as environment variables to avoid passing them on every command.

To pass credentials inline:

# Using an API key
temporal workflow list \
  --address <namespace>.<account>.tmprl.cloud:7233 \
  --namespace <namespace>.<account> \
  --api-key <your-api-key>

# Using mTLS certificates
temporal workflow list \
  --address <namespace>.<account>.tmprl.cloud:7233 \
  --namespace <namespace>.<account> \
  --tls-cert-path /path/to/client.pem \
  --tls-key-path /path/to/client.key

Log out​

To log out, run the temporal cloud logout command.

temporal cloud logout --profile prod

This will remove the OAuth token from the specified configuration profile. If you provided API keys or mTLS certificates, they will remain in the profile.

Cloud administration​

The Temporal Cloud extension adds temporal cloud commands for managing Cloud resources. Any of the authentication methods above grant access to these commands.

Install the extension:

brew install temporal-cloud

For the full list of temporal cloud commands, see the cloud command reference.

Next steps​