{"record":{"id":"e0c4cd3058bc47e5","repo":"BerriAI/litellm","slug":"missing-required-environment-variable-aws-region","errorCode":null,"errorMessage":"Missing required environment variable - AWS_REGION_NAME","messagePattern":"Missing required environment variable - AWS_REGION_NAME","errorType":"validation","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"litellm/secret_managers/aws_secret_manager.py","lineNumber":23,"sourceCode":"\nRequires:\n* `os.environ[\"AWS_REGION_NAME\"],\n* `pip install boto3>=1.28.57`\n\"\"\"\n\nimport ast\nimport base64\nimport os\nimport re\nfrom typing import Any, Final\n\nimport litellm\nfrom litellm.proxy._types import KeyManagementSystem\n\n\ndef validate_environment():\n    if \"AWS_REGION_NAME\" not in os.environ:\n        raise ValueError(\"Missing required environment variable - AWS_REGION_NAME\")\n\n\ndef load_aws_kms(use_aws_kms: bool | None):\n    if use_aws_kms is None or use_aws_kms is False:\n        return\n    try:\n        import boto3\n\n        validate_environment()\n\n        # Create a Secrets Manager client\n        kms_client: Final = boto3.client(\"kms\", region_name=os.getenv(\"AWS_REGION_NAME\"))\n\n        litellm.secret_manager_client = kms_client\n        litellm._key_management_system = KeyManagementSystem.AWS_KMS\n\n    except Exception as e:\n        raise e","sourceCodeStart":5,"sourceCodeEnd":41,"githubUrl":"https://github.com/BerriAI/litellm/blob/77b7c6c40c0c5aa5fbcb1d6a1825ac39ca8829b8/litellm/secret_managers/aws_secret_manager.py#L5-L41","documentation":"Module-level environment check for the AWS secret/KMS integration: it fires when AWS_REGION_NAME is absent from os.environ, meaning the AWS Secrets Manager/KMS client cannot be constructed. Set the variable before instantiating the manager or calling load_aws_kms.","triggerScenarios":"Thrown at litellm/secret_managers/aws_secret_manager.py:23 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Set AWS_REGION_NAME in the environment (e.g. export AWS_REGION_NAME=us-east-1) before initializing the AWS secret manager.","Alternatively configure the region via AWS config files or pass it through litellm's key_management_settings."],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"77b7c6c40c0c5aa5fbcb1d6a1825ac39ca8829b8","analyzedAt":"2026-08-18T11:44:31.656Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}