Migrating to Buzstorage
Switching media platforms doesn’t require updating thousands of URLs or rewriting application logic. Use our automated URL rewriters, fallback origin proxies, and batch CLI sync tools to migrate seamlessly.
Auto URL Rewriters
Map existing Cloudinary, S3, or Uploadcare URL structures directly to Buzstorage CDN endpoints at request time.
Fallback Origin Proxy
Missing assets are dynamically fetched from your legacy platform on first request, transformed, and cached at edge nodes.
CLI Batch Sync
Run background batch migration jobs using the Buzstorage CLI to transfer terabyte-scale asset vaults securely.
Migration Guides for Top Media Platforms
Migrating from Cloudinary
Map transformations, preserve asset public IDs, and bypass egress fees
Step 1: Configure Cloudinary Fallback Origin
In your Buzstorage Console under Settings → Origins, add your Cloudinary Cloud Name as a Fallback Origin:
# Add Cloudinary as fallback origin via CLI
buzstorage origin add --type=cloudinary \
--cloud-name="my-agency-cloud" \
--api-key="CLOUDINARY_API_KEY" \
--api-secret="CLOUDINARY_API_SECRET"Step 2: Update Media URL Rewriter
Existing Cloudinary URL transformation parameters map automatically to Buzstorage Edge parameters:
https://res.cloudinary.com/demo/image/upload/w_800,h_600,c_fill,q_auto,f_auto/sample.jpghttps://cdn.buzstorage.com/rewrite/demo/sample.jpg?width=800&height=600&fit=cover&format=autoMigrating from AWS S3 & CloudFront
Mount existing S3 buckets with Zero Egress fees or sync to Buzstorage Vaults
Option A: Bring Your Own Bucket (BYOS)
Keep your existing S3 bucket in place while serving media through Buzstorage’s global edge routing and transformation pipeline:
import { BuzstorageClient } from '@buzstorage/sdk';
const buz = new BuzstorageClient({ apiKey: process.env.BUZSTORAGE_API_KEY });
// Connect existing AWS S3 Bucket
const storage = await buz.integrations.connectS3({
bucketName: 'production-media-assets',
region: 'us-east-1',
accessKeyId: process.env.AWS_ACCESS_KEY_ID,
secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,
enableEdgeCache: true, // Enables global CDN caching
});Option B: High-Speed Bucket Sync CLI
To transfer files entirely out of AWS into native Buzstorage Vaults:
# High-speed parallel S3 sync CLI
buzstorage sync s3://my-production-bucket s3://vault.buzstorage.com/main \
--region=us-east-1 \
--concurrency=32 \
--preserve-metadataMigrating from Uploadcare & ImageKit
Replace upload widgets and dynamic image optimization APIs seamlessly
Drop-In SDK Replacement
Replace Uploadcare/ImageKit upload widgets with `@buzstorage/client` React or Vanilla JavaScript Uploader components:
import { BuzUploader } from '@buzstorage/react';
export function MediaUploader() {
return (
<BuzUploader
publicKey="pk_live_83921..."
maxFileSize="50GB"
acceptedFileTypes={['video/*', 'image/*', 'audio/*']}
onUploadComplete={(file) => console.log('File uploaded:', file.cdnUrl)}
/>
);
}