Page:
Troubleshooting FAQ
No results
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.
- Cause: The script, via the
-
Error:
AccessDenied
ons3: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.
- Project Wiki:
regularbm
- Introduction
- Core Concepts
- Pattern A
- Pattern B
- Getting Started - A Step-by-Step Guide
- Step 1: System Prerequisites
- Step 2: Deploy Cloud Infrastructure
- Step 3: Configure the Script Environment
- Step 4: Configure Server Permissions
- Step 5: Test and Automate
- Technical Deep Dive
- The Backup Process
- Packaging
- Configuration: Script Arguments
- Troubleshooting FAQ