# Introduction

> Learn how BucketMate helps you manage S3-compatible storage from a native macOS app

Canonical: https://docs.bucketmate.app/macos

BucketMate is a native macOS app for managing Amazon S3 and S3-compatible storage with a fast Finder-like interface. Use it to connect storage providers, browse buckets, upload and download files, preview objects, create share links, and organize storage accounts into workspaces.

## What BucketMate can manage

- Storage providers: Amazon S3, Google Cloud Storage, Cloudflare R2, Backblaze B2, DigitalOcean Spaces, Wasabi, Supabase Storage, MinIO, and custom S3-compatible endpoints.
- Connections: access keys, AWS profiles, AWS SSO profiles, manual bucket lists, and single-bucket endpoints for credentials without bucket-list permission.
- Buckets: create, refresh, empty, delete, pin, hide, reorder, and search buckets.
- Files and folders: browse hierarchy, upload files and folders, download files and folders, create folders, rename, move, delete, open, and quick edit text files.
- URLs and sharing: copy object names, public URLs, custom-domain URLs, and presigned share links with expiration.
- Preview and details: inline preview, Quick Look preview, image preview, text preview, PDF preview, metadata, storage class, size, modified date, and folder metrics.
- Organization: workspaces, pinned connections, hidden buckets, custom domains, saved bucket state, and local cache.

## Recommended first setup

1. Install BucketMate for macOS.
2. Open BucketMate and choose **Add Connection**.
3. Select your provider.
4. Enter a connection name, endpoint, region, and credentials.
5. Use **Test Connection** before saving.
6. If your credentials cannot list buckets, turn off **Credentials have permission to list buckets** and enter bucket names manually.
7. Open a bucket and use the file table to browse, upload, preview, copy URLs, or manage objects.

## Common workflows

### Connect storage

Use [Connect S3-compatible storage](/macos/features/connect-s3-compatible-storage) for the general connection flow, including custom endpoints, AWS profiles, manual bucket lists, and single-bucket endpoints.

### Manage files and buckets

Use [Manage files and buckets](/macos/features/manage-files-and-buckets) for upload, download, move, rename, delete, folder, bucket, URL copy, and large-bucket behavior.

### Preview and share files

Use [Preview, share, and edit files](/macos/features/preview-share-and-edit-files) for inline preview, Quick Look, file details, presigned links, share-link history, and quick edit.

### Organize the app

Use [Workspaces, settings, and shortcuts](/macos/features/workspaces-settings-and-shortcuts) for workspaces, pinned items, hidden buckets, download settings, cache settings, and keyboard shortcuts.

## Trial limits

The free trial is designed for testing one storage setup before upgrading.

- 1 connection
- Default workspace only
- Single-file operations for upload, download, copy, share, and delete
- Single-file upload up to 100 MB
- Multiple connections, workspaces, and bulk file operations require Pro

## Provider guides

- [AWS S3](/macos/providers/connect-aws-s3)
- [Google Cloud Storage](/macos/providers/connect-google-cloud-storage)
- [Cloudflare R2](/macos/providers/connect-cloudflare-r2)
- [Backblaze B2](/macos/providers/connect-backblaze-b2)
- [DigitalOcean Spaces](/macos/providers/connect-digitalocean-spaces)
- [Wasabi](/macos/providers/connect-wasabi)
- [Supabase Storage](/macos/providers/connect-supabase-storage)
- [MinIO](/macos/providers/connect-minio)