JonnyBurger/messages.md

Created March 3, 2026 13:23

Star (0) You must be signed in to star a gist
Fork (0) You must be signed in to fork a gist

Select an option

Learn more about clone URLs
Clone this repository at <script src="https://gist.github.com/JonnyBurger/a66aeef2f1012c428dff928b2a2f72f9.js"></script>
Save JonnyBurger/a66aeef2f1012c428dff928b2a2f72f9 to your computer and use it in GitHub Desktop.

Download ZIP

AI-generated docs draft: Update site when upgrading Remotion Lambdas for best practice.

Raw

messages.md

nota0966 - 3/2/2026, 10:41:56 PM

We are using Remotion Lambdas as well as rendering videos in our UI for user previews. I've been trying to document upgrade paths for our team and currently when we upgrade we bump all versions in our apps and also redeploy lambda functions as documented. However, I don't see any documentation around rebundling. My question is, when we upgrade and redeploy a Lambda, do we also need to create a new site to go with it? In which case we would probably deploy versioned sites ( e.g. npx remotion lambda sites create --site-name v4.0.245 ).

We haven't been doing this so far and haven't come across any issues, but it might just be good luck, so wanted to confirm best practice.

jonnyburger - 3/3/2026, 1:22:48 PM

yes, you should update the site https://www.remotion.dev/docs/lambda/upgrading if you don't, most often you get a warning, but when we make a protocol change, it will completely break

I think we can rewrite this page to be a bit more explicit about this

Raw

technical-note.md

Technical Note: Upgrade and Rebundling of Remotion Lambdas

Problem

When upgrading and redeploying Remotion Lambdas, it is essential to create a new site to avoid issues. Failing to do so may lead to warnings or, in the case of protocol changes, complete functionality breakage.

Reason

Upgrading the Lambdas typically requires a corresponding site update. Not updating the site can cause unexpected errors due to incompatibility between the Lambda version and the site currently in use.

Solution

We recommend following these steps when upgrading and redeploying a Lambda:

Upgrade Lambda Version: Increase the version of the Lambda functions as documented.
Create a New Site: Execute the command to create a new versioned site:
```
npx remotion lambda sites create --site-name v4.0.245
```
Deploy Site: Ensure the newly created site is deployed to align with the upgraded Lambda functions.

For detailed guidance, refer to the official document: Remotion Lambda Upgrading Documentation.