CLI: Init

The init command initializes a local, encrypted vault for DSO. This is the foundation of Local Mode.

Usage

docker dso init [flags]

Description

Running init will:

  1. Create the ~/.dso/ directory if it doesn't exist
  2. Prompt for a master password (or use DSO_MASTER_PASSWORD env)
  3. Generate a new AES-256-GCM encrypted vault file at ~/.dso/vault.enc

Flags

--path

Custom path for the vault file (default: ~/.dso/vault.enc)

--force

Overwrite existing vault file

Examples

Initialize with default settings:

docker dso init

Initialize with a specific path:

docker dso init --path ./my-project.vault

Reinitialize and overwrite existing vault:

docker dso init --force

⚠️ Important

Keep your master password safe. If lost, the data in vault.enc cannot be recovered.

Related Commands