Skip to main content

npx remotion lambda sites

The npx remotion lambda sites command allows to create, view and delete Remotion projects in your S3 bucket.

create

npx remotion lambda sites create <entry-point>?
npx remotion lambda sites create <entry-point>?

You may pass an entry point as the first argument, otherwise the entry point will be determined.

Bundle and upload a Remotion video to an S3 bucket.

The result will be a URL such as https://remotionlambda-12345.s3.eu-central-1.amazonaws.com/sites/abcdef/index.html.

note

If you make changes locally, you need to redeploy the site. Use --site-name to overwrite an existing site.

You can use this "Serve URL" to render a video on Remotion Lambda using:

If you are rendering on Lambda, you can also pass the site Name (in this case abcdef) as an abbreviation.

Example output
(1/3) [====================] Bundled video 3975ms
(2/3) [====================] Created bucket 457ms
(3/3) [====================] Uploaded to S3 25118ms

Deployed to S3!
Serve URL: https://remotionlambda-12345.s3.eu-central-1.amazonaws.com/sites/abcdef/index.html
Site Name: abcdef

--region

The AWS region to select. Both project and function should be in this region.

--site-name

Uploads the project to a specific directory and returns a deterministic URL. If a site already existed under this name, it will be overwritten. Can only contain the following characters: 0-9, a-z, A-Z, -, !, _, ., *, ', (, )

npx remotion lambda sites create src/index.ts --site-name=my-project
npx remotion lambda sites create src/index.ts --site-name=my-project

--force-bucket-namev3.3.42

Specify a specific bucket name to be used. This is not recommended, instead let Remotion discover the right bucket automatically.

--privacyv3.3.97

Either public (default) or no-acl if you are not using ACL. Sites must have a public URL to be able to be rendered on Lambda, since the headless browser opens that URL.

--public-dirv4.0.140

Define the location of the public/ directory. If not defined, Remotion will assume the location is the `public` folder in your Remotion root.

--enable-folder-expiryv4.0.32

When deploying sites, enable or disable S3 Lifecycle policies which allow for renders to auto-delete after a certain time. Default is null, which does not change any lifecycle policies of the S3 bucket. See: Lambda autodelete.

--throw-if-site-existsv4.0.141

Prevents accidential update of an existing site. If there are any files in the subfolder where the site should be placed, the function will throw.


ls

npx remotion lambda sites ls
npx remotion lambda sites ls

Get a list of sites. The URL that is printed can be passed to the render command to render a video.

Example output
Site Name Bucket Size Last updated
pr6fwglz05 remotionlambda-abcdefg 14.7 MB 2021-12-02
https://remotionlambda-abcdefg.s3.eu-central-1.amazonaws.com/sites/pr6fwglz05/index.html

testbed remotionlambda-abcdefg 14.7 MB 2021-12-02
https://remotionlambda-abcdefg.s3.eu-central-1.amazonaws.com/sites/testbed/index.html

--region

The AWS region to select. Both project and function should be in this region.

--quiet, -q

Returns only a list of space-separated sites.

npx remotion lambda sites ls -q
npx remotion lambda sites ls -q
Example output
pr6fwglz05 testbed

rm

Removes a site (or multiple) from S3 by its ID.

bash
npx remotion lambda sites rm abcdef
npx remotion lambda sites rm abcdef my-project # multiple at once
bash
npx remotion lambda sites rm abcdef
npx remotion lambda sites rm abcdef my-project # multiple at once
Example output
Site abcdef in bucket remotionlambda-gc1w0xbfzl (14.7 MB): Delete? (Y/n): Y
Deleted sites/abcdef/052787b08233d85edebfc4ce4610944e.mp4
Deleted sites/abcdef/258.bundle.js
Deleted sites/abcdef/15.bundle.js
Deleted sites/abcdef/249.bundle.js.map
Deleted sites/abcdef/263.bundle.js
Deleted sites/abcdef/143.bundle.js
Deleted sites/abcdef/258.bundle.js.map
Deleted sites/abcdef/15.bundle.js.map
Deleted sites/abcdef/185.bundle.js.map
Deleted sites/abcdef/249.bundle.js
Deleted sites/abcdef/143.bundle.js.map
Deleted sites/abcdef/185.bundle.js
Deleted sites/abcdef/1f2d09019ff34eed846a5151b8561d5b.mp4
Deleted sites/abcdef/263.bundle.js.map
Deleted sites/abcdef/268.bundle.js
Deleted sites/abcdef/378.bundle.js.map
Deleted sites/abcdef/268.bundle.js.map
Deleted sites/abcdef/378.bundle.js
Deleted sites/abcdef/2b91c5234e41d3c36d4bf6df37876958.webm
Deleted sites/abcdef/450.bundle.js
Deleted sites/abcdef/46.bundle.js.map
Deleted sites/abcdef/46.bundle.js
Deleted sites/abcdef/450.bundle.js.map
Deleted sites/abcdef/534.bundle.js.map
Deleted sites/abcdef/569.bundle.js
Deleted sites/abcdef/3577958454aa99ad707b596f65151746.webm
Deleted sites/abcdef/534.bundle.js
Deleted sites/abcdef/575.bundle.js.map
Deleted sites/abcdef/575.bundle.js
Deleted sites/abcdef/569.bundle.js.map
Deleted sites/abcdef/801.bundle.js
Deleted sites/abcdef/7badbf53d3130d91b90c46181a2ecdc4.webm
Deleted sites/abcdef/801.bundle.js.map
Deleted sites/abcdef/873.bundle.js
Deleted sites/abcdef/98.bundle.js.map
Deleted sites/abcdef/bff822b868a2b87b31877f3606c9cc13.mp3
Deleted sites/abcdef/873.bundle.js.map
Deleted sites/abcdef/98.bundle.js
Deleted sites/abcdef/a2f36e3a48b4989e0da1fea9959fb35f.mp3
Deleted sites/abcdef/bundle.js
Deleted sites/abcdef/bundle.js.map
Deleted sites/abcdef/a7d87d9934059032eebb9c1536378a2a.webm
Deleted sites/abcdef/index.html
Deleted site abcdef and freed up 14.7 MB.

--region

The AWS region to select. Both project and function should be in this region.

--yes, -y

Removes a site without asking for confirmation.

npx remotion lambda sites rm abcdef -y
npx remotion lambda sites rm abcdef -y

--force-bucket-namev3.3.42

Specify a specific bucket name to be used. This is not recommended, instead let Remotion discover the right bucket automatically.

rmall

Remove all sites in the selected AWS region.

bash
npx remotion lambda sites rmall
bash
npx remotion lambda sites rmall
Example output
Site abcdef in bucket remotionlambda-gc1w0xbfzl (14.7 MB): Delete? (Y/n): Y
Deleted sites/abcdef/052787b08233d85edebfc4ce4610944e.mp4
Deleted sites/abcdef/258.bundle.js
Deleted sites/abcdef/15.bundle.js
Deleted sites/abcdef/249.bundle.js.map
Deleted sites/abcdef/263.bundle.js
Deleted sites/abcdef/143.bundle.js
Deleted sites/abcdef/258.bundle.js.map
Deleted sites/abcdef/15.bundle.js.map
Deleted sites/abcdef/185.bundle.js.map
Deleted sites/abcdef/249.bundle.js
Deleted sites/abcdef/143.bundle.js.map
Deleted sites/abcdef/185.bundle.js
Deleted sites/abcdef/1f2d09019ff34eed846a5151b8561d5b.mp4
Deleted sites/abcdef/263.bundle.js.map
Deleted sites/abcdef/268.bundle.js
Deleted sites/abcdef/378.bundle.js.map
Deleted sites/abcdef/268.bundle.js.map
Deleted sites/abcdef/378.bundle.js
Deleted sites/abcdef/2b91c5234e41d3c36d4bf6df37876958.webm
Deleted sites/abcdef/450.bundle.js
Deleted sites/abcdef/46.bundle.js.map
Deleted sites/abcdef/46.bundle.js
Deleted sites/abcdef/450.bundle.js.map
Deleted sites/abcdef/534.bundle.js.map
Deleted sites/abcdef/569.bundle.js
Deleted sites/abcdef/3577958454aa99ad707b596f65151746.webm
Deleted sites/abcdef/534.bundle.js
Deleted sites/abcdef/575.bundle.js.map
Deleted sites/abcdef/575.bundle.js
Deleted sites/abcdef/569.bundle.js.map
Deleted sites/abcdef/801.bundle.js
Deleted sites/abcdef/7badbf53d3130d91b90c46181a2ecdc4.webm
Deleted sites/abcdef/801.bundle.js.map
Deleted sites/abcdef/873.bundle.js
Deleted sites/abcdef/98.bundle.js.map
Deleted sites/abcdef/bff822b868a2b87b31877f3606c9cc13.mp3
Deleted sites/abcdef/873.bundle.js.map
Deleted sites/abcdef/98.bundle.js
Deleted sites/abcdef/a2f36e3a48b4989e0da1fea9959fb35f.mp3
Deleted sites/abcdef/bundle.js
Deleted sites/abcdef/bundle.js.map
Deleted sites/abcdef/a7d87d9934059032eebb9c1536378a2a.webm
Deleted sites/abcdef/index.html
Deleted site abcdef and freed up 14.7 MB.

--region

The AWS region to select. Both project and function should be in this region.

--yes, -y

Removes all sites without asking for confirmation.

npx remotion lambda sites rmall -y
npx remotion lambda sites rmall -y

--force-bucket-namev3.3.42

Specify a specific bucket name to be used. This is not recommended, instead let Remotion discover the right bucket automatically.