1 Troubleshooting FAQ
first edited this page 2025-07-07 04:12:29 +00:00
  • Error: externally-managed-environment

    • Cause: Your Linux distribution is protecting its system-wide Python environment.
    • Solution: You must use a Python virtual environment (venv) as described in the Getting Started guide. Do not use --break-system-packages.
  • Error: Unable to locate credentials

    • Cause: The script, via the boto3 SDK, could not find any AWS credentials.
    • Solution: Verify your setup from Step 4: Configure Server Permissions. If on EC2, ensure the IAM Instance Profile is correctly attached. If external, ensure the ~/.aws/credentials file exists, is correctly formatted, and is readable by the user running the script.
  • Error: AccessDenied on s3:PutObject

    • Cause: Authentication was successful, but the IAM policy does not authorize the user/role to write to the specific S3 path.
    • Solution: This is a policy mismatch. Edit the IAM policy in the AWS console. Ensure the Resource ARN in the policy statement (e.g., arn:aws:s3:::your-bucket/your-prefix/*) exactly matches the bucket and prefix the script is trying to upload to.