Skip to main content

Installation

This page collects the prerequisites and installation options for @pagopa/dx-cli.

Requirements

The following tools must be installed on your machine:

ToolVersion
Node.js>= 22.0.0
Terraform or tfenvlatest
GitHub CLIlatest
Azure CLIlatest (required for Azure environments only)

Before running any command that interacts with GitHub or a cloud provider, ensure you are logged in:

gh auth login
az login
Azure session expiry

Within PagoPA, az login sessions expire every 12 hours. If a command fails with an authentication error, run az login again before retrying.

Installation

You can invoke the CLI directly via npx without installing globally:

npx @pagopa/dx-cli --help

When installed locally in a monorepo you can also run:

pnpm dx --help

The binary name is dx.