From d7d2952f9a1b07aa0bf37fbf301fbb9ae7fd8d4a Mon Sep 17 00:00:00 2001 From: first Date: Mon, 7 Jul 2025 04:12:29 +0000 Subject: [PATCH] Add Troubleshooting FAQ --- Troubleshooting-FAQ.md | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 Troubleshooting-FAQ.md 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