Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

import

Import secrets from a .env file into the local vault.

Usage

cred import <path> [OPTIONS]

Arguments

ArgumentDescription
<path>Path to the .env file to import

Options

OptionDescription
--overwriteOverwrite existing keys instead of skipping
-e, --env <name>Target environment (auto-detected from cred exports)

Behavior

Plain .env Files

When importing a standard .env file:

# Import to default environment
cred import .env

# Import to a specific environment
cred import .env --env prod

Secrets are imported as plain key-value pairs without metadata.

Cred Export Files

When importing a file created by cred export:

# Import preserving environments and metadata
cred import vault.env

Cred automatically detects export files by their header and:

  • Recreates environment structure from the file
  • Restores secret metadata (descriptions, timestamps)
  • Creates any environments that don’t exist

To force all secrets into a single environment:

# Override: import all secrets to staging environment
cred import vault.env --env staging

Examples

# Import from .env, skip existing keys
cred import .env

# Import and overwrite existing keys
cred import .env --overwrite

# Import to production environment
cred import prod.env --env prod

# Import a cred export file (auto-detects format)
cred import teammate-vault.env

# Preview what would be imported
cred import .env --dry-run

Output

✓ Imported .env (added 5, overwritten 0, skipped 2).

For cred export files with multiple environments:

✓ Imported vault.env (created 2 env(s)) (added 10, overwritten 0, skipped 0).