Troubleshooting
Most issues are endpoint, region, permissions, or provider behavior differences. This page covers the common fixes.
Connection and Credentials
InvalidAccessKeyId or authentication failed
Verify Key and Secret. Also confirm the endpoint belongs to the same provider account.
SignatureDoesNotMatch
Region and endpoint likely do not match. Confirm region and endpoint pair from provider console.
AccessDenied
Credentials are valid but missing permissions for this action or bucket.
NoSuchBucket
Bucket name, endpoint region, or account scope is incorrect.
Download or Save Problems
- If save panel fails, verify sandbox entitlement for user-selected files is enabled in your build.
- If move to Downloads fails, pick destination via save panel and retry.
- For large files, allow operation to complete before starting another transfer.
Performance with Large Folders
- List view is optimized for very large item counts.
- Grid view can be heavier due to thumbnail workload.
- Release builds are faster than Debug builds.
If behavior differs by provider, test with the same folder depth and item count to isolate provider-specific API constraints.
Operation Conflicts
- While upload/download/delete/copy is active, conflicting actions are disabled.
- Wait for completion or cancel current operation first.
When to Contact Support
Collect these details before reporting:
- S3 provider name
- Endpoint and region used
- Exact action that failed
- Error message shown in app