Skip to content
/ cli Public

The official CLI for interacting with your Doppler secrets and configuration.

License

Notifications You must be signed in to change notification settings

DopplerHQ/cli

Folders and files

NameName
Last commit message
Last commit date
Jun 13, 2024
Nov 28, 2023
Mar 3, 2021
Dec 10, 2024
Mar 1, 2024
Jul 10, 2023
Nov 21, 2024
Apr 5, 2023
Jun 13, 2024
Feb 4, 2020
Sep 14, 2020
Dec 12, 2019
Jul 10, 2023
Oct 15, 2019
Jun 13, 2024
Mar 28, 2024
Mar 21, 2022
Apr 7, 2021
May 10, 2023
Jan 6, 2025
Jan 6, 2025
Sep 21, 2022
Sep 7, 2023

Repository files navigation

Doppler CLI

The Doppler CLI is the official tool for interacting with your Doppler secrets and configuration.

You can:

  • Manage your secrets, projects, and environments
  • Execute applications with your secrets injected into the environment
  • View activity and audit logs

Install

The Doppler CLI is available in several popular package managers. It can also be installed via shell script, GitHub Action, or downloaded as a standalone binary.

For more info, including instructions on verifying binary signatures, see the Install page.

macOS

Using brew is recommended:

$ brew install dopplerhq/cli/doppler
$ doppler --version

To update:

$ brew upgrade doppler

For installation without brew, see the Install page.

Windows

Using winget is recommended:

$ winget install doppler
$ doppler --version

To update:

$ winget upgrade doppler

For additional options, see the Install page.

Shell script

This option is recommend for CI jobs and other environments that won't make use of package manager updates.

$ (curl -Ls --tlsv1.2 --proto "=https" --retry 3 https://cli.doppler.com/install.sh || wget -t 3 -qO- https://cli.doppler.com/install.sh) | sh

For more info, see the Install page.

Linux

See Install page for instructions.

Docker

See Install page for instructions.

GitHub Action

You can install the latest version of the CLI via GitHub Action. See the cli-action repo for more info.

Usage

Setup should only take a minute (literally). You'll authorize the CLI to access your Doppler workplace, and then select your project and config.

$ doppler login                     # generate auth credentials
$ doppler setup                     # select your project and config
# optional
$ doppler configure --all           # view local configuration

By default, doppler login scopes the auth token to the root directory (--scope=/). This means that the token will be accessible to projects using the Doppler CLI in any subdirectory. To limit this, specify the scope flag during login: doppler login --scope=./ or doppler login --scope ~/projects/backend.

Setup (i.e. doppler setup) scopes the selected project and config to the current directory (--scope=./). You can also modify this scope with the scope flag. Run doppler help for more information.