slug: "how-to-configure-s3-cloud-sync" title: "How to Configure S3 Cloud Sync for Cross-Device Clipboard" description: "A complete guide to configuring S3-compatible cloud storage (such as Cloudflare R2, Aliyun OSS, or Bitiful) to sync your clipboard history anywhere." date: "June 10, 2026" category: "Sync" coverWatermark: "Cloud Sync" coverGradient: "radial-gradient(circle at 20% 20%, #00b4d8 0%, transparent 40%), radial-gradient(circle at 80% 80%, #0077b6 0%, transparent 40%), #0b0f19" coverKeycaps: ["S", "3"] coverBadge: "cloud" coverHighlight: "from-cyan-400 to-blue-500" platforms: ["all"] readTime: "4 min read" mockupItems:

  • type: "safari" text: "https://s3.bitiful.com/bucket-octoclip"
  • type: "macbook" text: "AccessKey: LTAI5t9m... SecretKey: 8dx91s..."
  • type: "iphone" text: "Cloud sync initialized successfully."

How to Configure S3 Cloud Sync for Cross-Device Clipboard

Clipboard synchronization should be fast, reliable, and secure. While local network sync (Nearby Sync) is ideal when your devices are on the same Wi-Fi, S3-compatible cloud synchronization keeps your clipboard history updated even when you are on different networks (e.g., home and office).

Octoclip supports any S3-compatible object storage provider, such as Cloudflare R2, AWS S3, Aliyun OSS, and Bitiful Cloud. This guide walks you through the concepts and step-by-step configuration.

What Is S3 Cloud Sync?

S3 (Simple Storage Service) is a widely used protocol for cloud storage. By configuring S3 cloud sync, Octoclip stores your clipboard history in an encrypted database file within your own private cloud storage bucket.

Whenever you copy something on your phone or computer, the app safely pushes the update to your storage bucket, and your other devices pull the change instantly.

Why Use S3-compatible Storage?

  • Zero-knowledge Privacy — You own the storage bucket. Octoclip encrypts your clipboard content locally before uploading, meaning neither your cloud provider nor Octoclip can read your data.
  • Cross-network Sync — Seamless clipboard sync between home, office, and mobile cellular networks.
  • Cost-effective — Most S3-compatible services offer generous free tiers (e.g., Cloudflare R2 offers 10 GB free storage per month) which is more than enough for lifetime clipboard text and image sync.

Step-by-Step Configuration (Using Bitiful Cloud as an Example)

Step 1: Create an Account and Bucket

  1. Visit Bitiful Cloud (or your preferred S3 provider console) and sign in.
  2. Navigate to Object Storage -> Bucket List and click Create Bucket.
  3. Enter a unique bucket name (e.g., octoclip-sync-yourname) and set the permissions to Private.
  4. Save your bucket name and region.

::: info Note Storage bucket names must be globally unique across the cloud service provider. Once created, a bucket name cannot be modified. :::

Step 2: Generate Access Keys

To allow Octoclip to read and write to your bucket securely, you must generate API access keys:

  1. Navigate to AccessKey or API Keys in your S3 provider's console.
  2. We highly recommend creating a Sub-User (IAM User) with access restricted only to the bucket you created, rather than using your main account root keys.
  3. Generate a new key pair and copy down:
    • Access Key (ID)
    • Secret Key (Secret)
  4. Ensure the user or access key has full Read and Write permissions for the designated bucket.

Configuring S3 in the Octoclip Client

Once you have your credentials, open Octoclip on any device (macOS, iOS, Windows, or Android):

  1. Go to Settings -> Cloud Sync.
  2. Select S3 as your sync type.
  3. Fill in the following connection parameters:
    • Access Key: The API access key ID you copied.
    • Secret Key: The API secret key.
    • Endpoint: The S3 endpoint URL (e.g., s3.bitiful.com or https://<account_id>.r2.cloudflarestorage.com for Cloudflare).
    • Bucket: The exact name of your bucket.
    • Region: The region code (e.g., cn-east-1 or auto).
  4. Click Test Connection. Once successful, tap Save and Enable.

Now, configure S3 sync on your other devices using the exact same parameters to link your clip histories.

Frequently Asked Questions

Is S3 sync free?

Octoclip does not charge extra for S3 sync features. Any fees would come from your S3 storage provider. However, since clipboard sync databases are typically under 50 MB, you will remain well within the free tiers of providers like Cloudflare R2 or Backblaze B2 indefinitely.

Does S3 sync support images and files?

Yes. Octoclip syncs text, URLs, and image clips. To save bandwidth and storage, you can configure maximum size limits for image sync in the settings. Large files (like videos) are not synced to prevent performance lags.

How often does the sync run?

Octoclip runs a lightweight sync merge immediately after it detects a new copy event, and periodically pulls updates from the cloud when the app is active, delivering near-instant updates across devices.

Troubleshooting

Connection failed or timed out?

Verify your Endpoint and Region fields. Ensure you include https:// in the endpoint if required by your provider. Check if your local network is blocking the S3 provider domain.

Permission Denied (403 Forbidden)?

Double check your Access Key and Secret Key. Ensure the sub-user has policies attached allowing s3:GetObject, s3:PutObject, and s3:ListBucket operations on the designated bucket.

Need Extra Assistance?

If your cloud sync fails to initialize, reach out to us at support@octoclip.app or join the discussion in our Community Forum. Please provide:

  • The S3 provider name (e.g., Cloudflare, Bitiful, Aliyun)
  • Your device OS versions
  • Any connection error messages displayed by the app