Skip to main content

@remotion/lambda

Render Remotion videos on AWS Lambda. This is the fastest, most cost-efficient and most scalable way to render Remotion videos.

When should I use it?​

If one of those those constraints is a dealbreaker for you, resort to normal server-side rendering.

How it works​

  • A Lambda function and a S3 bucket is created on AWS.
  • A Remotion project gets deployed to a S3 bucket as a website.
  • The Lambda function gets invoked and opens the Remotion project.
  • A lot of Lambda functions are created in parallel which each render a small part of the video
  • The initial Lambda function downloads the videos and stitches them together.
  • The final video gets uploaded to S3 and is available for download.

Architecture​

  • Lambda function: Requires a layer with Chromium and FFMPEG, currently hosted by Remotion. Only one Lambda function is required, but it can execute different actions.
  • S3 bucket: Stores the projects, the renders, and render metadata.
  • CLI: Allows to control the overall architecture from the command line. Is installed by adding @remotion/lambda to a project.
  • Node.JS API: Has the same features as the CLI but is easier to use programmatically

Setup / Installation​

See here

Region selection​

The following regions are available for Remotion Lambda:

  • eu-central-1
  • eu-west-1
  • eu-west-2
  • us-east-1
  • us-east-2
  • us-west-2
  • ap-south-1
  • ap-southeast-1
  • ap-southeast-2
  • ap-northeast-1

See here for configurations and considerations.

Limitations​

Cost​

Most of our users render multiple minutes of video for just a few pennies. The exact cost is dependent on the region, assigned memory, type of video, parallelization and other parameters. For each render, we estimate a cost and display it to you. You might also need a Remotion license (see below).

AWS permissions​

Remotion Lambda requires you to create an AWS account and create a user with some permissions attached to it. We require only the minimal amount of permissions required for operating Remotion Lambda.

Read more about permissions

CLI​

You can control Remotion Lambda using the npx remotion lambda command.

Read more about the CLI

Node.JS API​

Everything you can do using the CLI, you can also control using Node.JS APIs. Refer to the left sidebar to see the list of available APIs.

License​

The standard Remotion license applies. https://github.com/remotion-dev/remotion/blob/main/LICENSE.md

Companies need to buy 1 cloud rendering seat per 2000 renders per month - see https://companies.remotion.dev/

Uninstalling​

We make it easy to remove all Remotion resources from your AWS account without leaving any traces or causing further costs.

How to uninstall Remotion Lambda