Skip to main content

getOrCreateBucket()

Creates a bucket for Remotion Lambda in your S3 account. If one already exists, it will get returned instead.

Only 1 bucket per region is necessary for Remotion Lambda to function.

ts
import { getOrCreateBucket } from "@remotion/lambda";
 
const { bucketName } = await getOrCreateBucket({ region: "us-east-1" });
 
console.log(bucketName); // "remotionlambda-32df3p"
ts
import { getOrCreateBucket } from "@remotion/lambda";
 
const { bucketName } = await getOrCreateBucket({ region: "us-east-1" });
 
console.log(bucketName); // "remotionlambda-32df3p"

Arguments​

An object with the following property:

region​

The AWS region which you want to create a bucket in.

onBucketEnsured?​

removed in v4.0, optional

Allows to pass a callback after the bucket was created and before the S3 website option was enabled. This option exists so the CLI can better visualize the progress.
Removed in v4.0 since we don't use the website option anymore.

Return value​

A promise resolving to an object with the following properties:

bucketName​

The name of your bucket that was found or created.

alreadyExisted​

A boolean indicating whether the bucket already existed or was newly created.

See also​