BucketMate
Providers

AWS S3

Step-by-step guide to connect AWS S3 to BucketMate for macOS with access keys, AWS CLI profiles, or AWS SSO, plus region and permission tips.

BucketMate can connect to AWS S3 with static access keys, local AWS profiles, or AWS SSO profiles from your Mac.

Prerequisites

  • AWS Account
  • Access Key ID and Secret Access Key, or a profile in ~/.aws/config or ~/.aws/credentials
  • AWS CLI installed when using an AWS SSO profile
  • S3 bucket access
  • Region for the bucket you want to manage

Start with the narrowest policy that matches your workflow. BucketMate features can require these S3 actions:

  • s3:ListAllMyBuckets to load all buckets automatically
  • s3:ListBucket to browse a bucket
  • s3:GetObject to download, preview, open, and share files
  • s3:PutObject to upload, create folders, rename, move, and quick edit
  • s3:DeleteObject to delete, rename, move, and empty buckets
  • s3:CreateBucket to create buckets
  • s3:DeleteBucket to delete empty buckets
  • s3:GetBucketVersioning, s3:PutBucketVersioning, s3:ListBucketVersions, s3:GetObjectVersion, and s3:DeleteObjectVersion for bucket versioning
  • s3:GetLifecycleConfiguration and s3:PutLifecycleConfiguration to auto-delete old versions
  • s3:RestoreObject to restore archived files

If you do not allow s3:ListAllMyBuckets, turn off Load all buckets and enter bucket names manually.

Connection steps

Access key

  1. Open BucketMate.
  2. Choose Add connection.
  3. Select AWS S3.
  4. Select Access Key.
  5. Leave endpoint empty, or enter https://s3.<region>.amazonaws.com.
  6. Enter the access key ID and secret access key.
  7. Select the bucket region.
  8. Use Test Connection.
  9. Choose Connect.

AWS profile and SSO

  1. Configure an AWS profile with the AWS CLI. For SSO, run aws configure sso --profile <profile-name>.
  2. Open BucketMate.
  3. Choose Add connection.
  4. Select AWS S3.
  5. Select AWS Profile.
  6. Choose a detected profile. Type in the picker to search. SSO profiles include (SSO) in the profile name.

BucketMate Add Connection dialog showing AWS Profile authentication and profile selection

  1. For an SSO profile, choose Login with SSO. BucketMate opens your browser automatically.
  2. Enter the verification code shown in BucketMate and finish signing in.

BucketMate waiting for AWS SSO login with a verification code and browser URL

  1. Return to BucketMate after the SSO login succeeds.
  2. Select the bucket region. BucketMate fills it in from the profile when the profile has a region.
  3. For a non-SSO profile, use Test Connection.
  4. Choose Connect.

Endpoint and region

AWS S3 usually works best with an empty endpoint and the correct region. Use a region-specific endpoint only when your setup requires it.

RegionEndpoint
us-east-1https://s3.us-east-1.amazonaws.com
us-west-2https://s3.us-west-2.amazonaws.com
Custom AWS-compatible endpointUse the provider endpoint instead of AWS S3

Common issues and fixes

Endpoint and region mismatch

If the endpoint does not match the bucket region, AWS can return 301 PermanentRedirect errors. Fix by using the bucket's region-specific endpoint, especially for buckets outside us-east-1.

Path-style URL deprecation

Path-style URLs are planned for discontinuation. Fix by switching to virtual-hosted-style URLs for new integrations.

Buckets do not load

If the credentials can access a bucket but cannot list all buckets, disable bucket listing and add bucket names manually.

SSO profile is expired

When BucketMate shows SSO session expired, choose Log in again. You can also edit the connection and use Login with SSO.

AWS profiles do not appear

BucketMate reads profiles from ~/.aws/config and ~/.aws/credentials. If it shows No profiles found, create a profile with the AWS CLI first. SSO login requires the AWS CLI.

Access denied on preview or download

Preview, open, download, and share-link creation need object read permission. Add s3:GetObject for the target bucket path.