Neon CLI

The Neon CLI is a command-line interface that lets you manage Neon directly from the terminal. This documentation references all commands and options available in the Neon CLI.

For installation instructions, see Neon CLI — Install and connect.

Synopsis

Commands

Global options

Global options are supported with any Neon CLI command.

• -o, --output

  Sets the output format. Supported options are json, yaml, and table. The default is table. Table output may be limited. The json and yaml output formats show all data.

• --config-dir

  Specifies the path to the neonctl configuration directory. To view the default configuration directory containing you credentials.json file, run neonctl --help. The credentials file is created when you authenticate using the neonctl auth command. This option is only necessary if you move your neonctl configuration file to a location other than the default.

• --api-key

  Specifies your Neon API key. You can authenticate using a Neon API key when running a Neon CLI command instead of using neonctl auth. For information about obtaining an Neon API key, see Create an API key.

  To avoid including the --api-key option with each CLI command, you can export your API key to the NEON_API_KEY environment variable.

  info

  The authentication flow for the Neon CLI follows this order:

  • If the --api-key option is provided, it is used for authentication.
  • If the --api-key option is not provided, the NEON_API_KEY environment variable setting is used.
  • If there is no --api-key option or NEON_API_KEY environment variable setting, the CLI looks for the credentials.json file created by the neonctl auth command.
  • If the credentials file is not found, the Neon CLI initiates the neonctl auth web authentication process.

• --analytics

  Analytics are enabled by default to gather information about the CLI commands and options that are used by our customers. This data collection assists in offering support, and allows for a better understanding of typical usage patterns so that we can improve user experience. Neon does not collect user-defined data, such as project IDs or command payloads. To opt-out of analytics data collection, specify --no-analytics or --analytics false.

• -v, --version

  Shows the Neon CLI version number.

• -h, --help

  Shows the neonctl command-line help. You can view help for neonctl, a neonctl command, or a neonctl subcommand, as shown in the following examples:

GitHub

The GitHub repository for the Neon CLI is found here.