doppler-projects

Get all projects

$ doppler projects

$ doppler projects get [name|project_id]

$ doppler projects create [name]

$ doppler projects update [name|project_id] --name "[new_name]" --description "[new_description]"

$ doppler projects delete [name|project_id]

doppler projects <list|create|update|delete> [args...] [--json] [--plain] [--team <team>] [-h, --help]

list
    List all accessible projects in plain or JSON format

create <name>
    Create a new project with given name

update <name>
    Update existing project's name or description

delete <name>
    Delete a project and its configs (irreversible)

--description <text>
    Set project description (create/update)

--json
    Output as JSON

--plain
    Output without headers or formatting

--team <team-name>
    Specify team scope

--verbose, -v
    Enable verbose logging

-h, --help
    Show command help

The doppler projects command is a subcommand of the Doppler CLI, a unified secrets and configuration management tool. Doppler projects act as logical containers grouping related configurations (e.g., for an application across environments like dev, staging, prod). This command enables listing, creating, updating, and deleting projects.

Key uses include team collaboration on secrets without exposing them. Before use, authenticate via doppler login or API token. It supports team-scoped operations for enterprise setups.

For example, list projects with doppler projects list, create one with doppler projects create my-app --description "My application project". Output formats include JSON for scripting or plain text for readability. Integrates seamlessly with CI/CD pipelines for dynamic secret injection.

Projects are foundational in Doppler's hierarchy: Account > Team (optional) > Project > Config > Secrets. Deleting a project cascades to configs unless protected. Ideal for developers, DevOps, and security teams managing secure configs at scale.

Requires prior doppler login or --token. Deleting projects removes all child configs irreversibly. Team members need appropriate permissions. Not for production secret injection; use doppler run instead.

Install via brew install dopplerhq/tap/doppler (macOS), curl -sLf https://cli.doppler.com/install.sh | sh, or package managers.

doppler projects list --json
doppler projects create myproject --description "Test project" --team myteam
doppler projects delete myproject

Introduced in Doppler CLI v1.0 (2020) by Doppler.dev. Evolved with team support in v2.x; JSON output and fields filtering added in v3+. Actively maintained as open-source on GitHub.

doppler(1), doppler-configs(1), doppler-secrets(1), doppler-login(1)