primemover/regularbm
primemover/regularbm
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Add Troubleshooting FAQ

first 2025-07-07 04:12:29 +00:00
parent 015ea2e3cc
commit d7d2952f9a
1 changed files with 11 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

11
Troubleshooting-FAQ.md Normal file

@ -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.