Env-mage Docs

Validate

Check env files

validate

Ensures your environment file contains all required variables defined in your template.

Usage

env-mage validate [options]

Options

OptionDescriptionDefault
--file <path>File to check.env
--template <path>Template file.env.example
--strictFail if extra keys foundfalse
--requiredOnly check required variables (marked with * in template)false

Example

env-mage validate --file .env.production

Example Output

✓ Reading .env file
✓ Reading template file
✓ All 8 required variables are present
✓ Validation passed!

OR (failure case):

✓ Reading .env file
✓ Reading template file
✗ Missing variables: API_KEY, DATABASE_URL
✗ Validation failed: 2 variables missing

Things to Know

  • Use in CI/CD pipelines to prevent deployments with missing variables
  • Mark required variables in template with * prefix (e.g., API_KEY*=)
  • --strict mode ensures no unexpected variables exist
  • Exit code is non-zero on failure (useful for scripts)