Before you start
Create a dedicated bucket and scoped credentials, then open Framecho › Settings › Cloud › S3-compatible storage.
- Create a dedicated Framecho bucket and note its name and region.
- Create application credentials scoped to this bucket with upload, read, multipart, and delete permissions. Do not use root credentials.
- Choose private or public mode. Private mode needs no public bucket; public mode also needs a public object domain.
- Select Verify Connection. Framecho uploads, reads, and deletes a small test object.
Private bucket + expiring links
The bucket stays private. Framecho signs every object for 1 hour, 24 hours, or 7 days; access ends automatically.
Public read + permanent links
Links do not expire, but anyone with an object URL can read it. Allow public read only—never public write—and use a custom domain for share pages.
Mask both the Access Key ID and Secret in screenshots and support tickets. Use a separate bucket-scoped key and revoke it immediately if exposed.
Map fields into Framecho
With a built-in provider, enter only the region and Framecho builds the endpoint. Enter an endpoint manually only for Custom.
Choose your provider
Alibaba Cloud OSS
Use a RAM user AccessKey. Keep the bucket private; public HTML pages need a custom domain to open in a browser.
- Create an OSS bucket and copy its Region ID.
- Create a dedicated RAM user and AccessKey scoped to object read, write, and delete in the bucket.
- Choose Alibaba Cloud OSS in Framecho and enter the region, bucket, AccessKey ID, and AccessKey Secret.
- Use Private and verify. Configure public read only when permanent public URLs are required.
cn-hongkongyour-bucketRAM AccessKey IDRAM AccessKey SecretOSS forces HTML to download on its default domain. Use a custom domain in Public mode for browser share pages; never enable public write.
Tencent Cloud COS
COS maps CAM SecretId and SecretKey to S3 credentials. Bucket names normally include the APPID.
- Create a COS bucket and copy its Region ID and full name including APPID.
- Create a scoped CAM user/key with object read, write, and delete permissions.
- Choose Tencent Cloud COS; put SecretId in Access Key ID and SecretKey in Secret Access Key.
- Use private expiring links, or grant anonymous read and enter a public domain.
ap-shanghaiexample-1250000000SecretIdSecretKeyCOS default domains may force HTML downloads. For browser share pages, use an approved custom or CDN domain in Public mode.
Cloudflare R2
R2 needs your Account ID and R2-specific API token credentials—not a general Cloudflare API token.
- Create an R2 bucket.
- Under Manage API Tokens, create an Object Read & Write token scoped to the bucket.
- Save the one-time Secret Access Key, Access Key ID, and your Cloudflare Account ID.
- Choose Cloudflare R2 in Framecho, fill all fields, and verify.
Cloudflare Account IDautoR2 Access Key IDR2 Secret Access KeyFor public mode, attach a custom domain. r2.dev is rate-limited and intended for development. Private mode does not need Public Development URL.
Backblaze B2
Create a standard Application Key. The Master Application Key does not work with the S3-compatible API.
- Copy the bucket Endpoint and its region, such as us-east-005.
- Under Application Keys, create a standard key with read/write access to the bucket.
- Put the 25-character keyID in Access Key ID and the one-time applicationKey in Secret Access Key.
- Choose Backblaze B2, enter region and bucket, and verify.
us-east-005your-bucket25-character keyIDapplicationKeyDo not enter the 12-character account/master ID, bucket ID, or key name. The region must exactly match the bucket Endpoint.
Amazon S3
Use long-term access keys for a dedicated IAM principal scoped to the Framecho bucket and prefix.
- Create an S3 bucket and note its Region.
- Create an IAM identity/key with Put/Get/Delete, ListBucket, and multipart permissions on the bucket.
- Choose Amazon S3 and enter Region, Bucket, Access Key ID, and Secret Access Key.
- Keep Block Public Access enabled and use private expiring links.
ap-east-1your-bucketIAM Access Key IDIAM Secret Access KeyNever use AWS root credentials. Public mode requires deliberate Block Public Access and read-only bucket-policy changes and is riskier.
Qiniu, MinIO, and other S3 services
Any HTTPS SigV4 service supporting PUT, multipart upload, GET, and batch delete can be tested.
- Copy the public S3 API endpoint and signing region from the provider.
- Choose Custom and enter the full HTTPS endpoint, region, bucket, and credentials.
- Select virtual-hosted or path-style addressing as required; MinIO often uses path-style.
- Run verification and use the service only after upload, read, and delete all pass.
https://s3.example.comus-east-1As requiredS3 Access Key / Secret KeyFor Qiniu Kodo, use the S3 public endpoint shown in the bucket overview; the Region is the region segment in that endpoint.
Troubleshooting
SignatureDoesNotMatchThe secret, region, endpoint, or system clock differs. Recopy credentials and use the region of the same bucket.
NoSuchBucketBucket name and region do not match. For Tencent COS, include the APPID suffix.
InvalidAccessKeyIdThe wrong credential type or field was used. B2 requires the 25-character keyID of a standard Application Key.
NSURLErrorDomain -1003The endpoint hostname does not resolve. Check for a console URL, private endpoint, bucket domain, typo, or bad region.
Link downloads instead of openingOSS/COS default-domain policy or the file type can force downloads. Use a custom domain in Public mode for browser HTML pages.
Upload passes but read failsThe key can write, but the bucket/domain cannot read, or the public domain points at another bucket.
Run verification once more
After all three checks pass, uploads go straight to your bucket and credentials remain in the macOS Keychain.