diff --git a/Troubleshooting-FAQ.md b/Troubleshooting-FAQ.md new file mode 100644 index 0000000..d5ac31a --- /dev/null +++ b/Troubleshooting-FAQ.md @@ -0,0 +1,11 @@ +- **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. \ No newline at end of file