Errors

Error codes surfaced by Dotenvx and Armor.

Errors are written to stderr in the form [ERROR_CODE] message. Use the code to identify the failure independently of its contextual message.

Dotenvx

Error Description
1PASSWORD_FAILED 1Password could not resolve a referenced value.
ACCESS_APPROVAL_TIMEOUT The CLI stopped waiting for Armor key-access approval.
BITWARDEN_FAILED Bitwarden could not resolve a referenced value.
BW_SESSION_MISSING Bitwarden requires an active session.
COMMAND_EXITED_WITH_CODE The command run by Dotenvx exited unsuccessfully.
COMMAND_SUBSTITUTION_FAILED Command substitution in an environment value failed.
DECRYPTION_FAILED One or more encrypted values could not be decrypted.
FILE_NOT_WRITABLE Dotenvx cannot write to the target file.
INVALID_COLOR The requested terminal color setting is invalid.
INVALID_CONVENTION The requested environment-file convention is invalid.
INVALID_PASSPHRASE The passphrase could not unlock the private key.
INVALID_PRIVATE_KEY The supplied private key is invalid.
INVALID_PUBLIC_KEY The supplied public key is invalid.
MALFORMED_ENCRYPTED_DATA The encrypted value is malformed.
MISPAIRED_PRIVATE_KEY The private key does not match the expected public key.
MISSING_DIRECTORY The requested directory does not exist.
MISSING_ENV_EXAMPLE The expected .env.example file does not exist.
MISSING_ENV_FILE The requested environment file does not exist.
MISSING_ENV_FILES No matching environment files were found.
MISSING_ENV_KEYS_FILE The requested .env.keys file does not exist.
MISSING_KEY The requested environment key does not exist.
MISSING_LOG_LEVEL The requested log level is not implemented.
MISSING_PRIVATE_KEY No private key is available for decryption.
MISSING_PUBLIC_KEY No public key is available for encryption.
MISSING_REQUIRED A required environment value is missing.
MISSING_VALUE No value was provided for the requested key.
PRECOMMIT_HOOK_MODIFY_FAILED Dotenvx could not modify the Git pre-commit hook.
PROMPT_CANCELLED An interactive prompt was cancelled.
VALIDATION_FAILED Environment validation failed.
WRONG_PRIVATE_KEY The available private key cannot decrypt the value.

Armor

Error Description
ACCESS_APPROVAL_EXPIRED The key-access approval expired before it was completed.
ACCESS_APPROVAL_INVALID The key-access approval token is invalid.
ACCESS_APPROVAL_PENDING The key-access request is still awaiting approval.
ACCESS_APPROVAL_REQUIRED The keypair requires interactive access approval.
ARMOR_UPGRADE_REQUIRED The installed Dotenvx Armor client must be upgraded.
DECRYPTION_FAILED Armor could not decrypt the supplied encrypted values.
DEVICE_PUBLIC_KEY_MISSING The request is missing DOTENVX_DEVICE_PUBLIC_KEY.
DOTENVX_SYNC_CONFLICT Local sync changes conflict with a newer server version.
NO_TEAMS Create or join a team before running the command.
PERMISSION_DENIED The authenticated member is not permitted to perform the action.
PROJECT_ID_MISSING The request is missing DOTENVX_PROJECT_ID.
PROJECT_ID_NOT_FOUND The requested DOTENVX_PROJECT_ID does not exist.
SERVER_SIDE_DECRYPTION_REQUIRED The private key cannot be returned; Armor must perform decryption.
SYNC_ACCESS_DENIED The authenticated member cannot access one or more synchronized files.
DOTENVX_TEAM_REQUIRED The request must identify a team.
UNAUTHORIZED The request is not authenticated.