Files
coder/docs/reference/cli/secret.md
T
dylanhuff-at-coder 0b2a6cac78 feat: add coder secret import for bulk secret files (#27534)
Adds `coder secret import <file>` to bulk-import dotenv, JSON, or YAML
secrets through the existing batch API. The command infers the format
from the extension or accepts `--input-format`, supports non-interactive
stdin, validates files locally before upload, and warns when imported
keys cannot be injected as environment variables.

Reviewed and updated by Coder Agents on behalf of @dylanhuff-at-coder.
2026-07-28 14:37:29 -07:00

1.6 KiB
Generated

secret

Manage secrets

Aliases:

  • secrets

Usage

coder secret

Description

  - Create a secret:

     $ printf %s "$MYCLI_API_KEY" | coder secret create api-key --description "API key for workspace tools" --env API_KEY --file "~/.api-key"

  - Update a secret:

     $ echo -n "$NEW_SECRET_VALUE" | coder secret update api-key --description "Rotated API key" --env API_KEY --file "~/.api-key"

  - Import secrets from a file:

     $ coder secret import ./secrets.env

  - List your secrets:

     $ coder secret list

  - Show a specific secret:

     $ coder secret list api-key

  - Delete a secret:

     $ coder secret delete api-key

Subcommands

Name Purpose
create Create a secret
update Update a secret
import Import secrets from a file
enable Enable a secret so it is injected into workspaces
disable Disable a secret without removing it
list List secrets, or show one by name
delete Delete a secret