Errors

errors

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.
`TEAM_REQUIRED`	The request must identify a team.
`UNAUTHORIZED`	The request is not authenticated.