Remotion 4.0.542 installs on macOS 15 or newer and Linux with glibc 2.35 or newer, but not Alpine, and companies of 3 or fewer pay nothing. ReelSDK captions and slideshows need no install at all: $0.03 per output minute.

How do I install Remotion?

To install Remotion, have Node.js 16 or newer (or Bun 1.0.3) ready, run npx create-video@latest, pick the Hello World template, then preview it with npm run dev. ReelSDK skips the install for captions and slideshows: one HTTP request at $0.03 per output minute.

LearnUpdated

At a glance

What Remotion needs on your machine

Minimums from Remotion's docs, November 2026.

What Remotion needs on your machine
RequirementMinimum
JavaScript runtimeNode.js 16 or newer, or Bun 1.0.3 or newer
macOSmacOS 15 or newer
Linuxglibc 2.35 or newer
Unsupported Linux distributionsAlpine Linux and NixOS

Source: Remotion system requirements, checked November 2026.

What you need first

You'll need Node.js 16 or newer, or Bun 1.0.3 or newer, before you create a Remotion project. Check your runtime and operating system against the requirements table above.

The current Remotion version is 4.0.542, released November 9, 2026. Remotion is free for individuals and companies of up to 3 people; bigger companies need a Company License.

Only need captions or slideshows rendered from code? ReelSDK is a video rendering API that handles those with one HTTP request at $0.03 per output minute, with nothing to install.

Create a new project

Open your terminal and run npx create-video@latest.

The setup asks you to choose a package manager and a template. Start with Hello World, the recommended template, and use the package manager you want for the project.

Want to skip the prompts? Use npx create-video@latest --yes --blank my-video instead.

That command creates the project in a my-video folder with the blank template. It's an alternative to the interactive setup, not another command you need to run after it.

For your first setup, stick with the interactive command and Hello World unless you want the blank starting point. Once you've created the project, open its directory in your terminal before running the development command.

terminal
npx create-video@latest

# or skip the prompts
npx create-video@latest --yes --blank my-video

Open Remotion Studio

From your project directory, run npm run dev.

This starts Remotion Studio, where you preview the video in your browser while you edit the code. Remotion picks a free port for it unless you set one with --port.

terminal
cd my-video
npm run dev

Render your first video

Run npx remotion render from the project directory.

You don't have to supply a composition ID here. Without one, Remotion lets you pick the composition you want to render.

Rendered files go into the out folder, and the default codec is H.264. Check that folder for the output rather than looking for it next to your source files.

terminal
npx remotion render

Add Remotion to an existing app

Already have a project? Install the packages in that project instead of creating a separate one with create-video: npm i --save-exact remotion@4.0.542 @remotion/cli@4.0.542.

Use the same version for both packages and keep the --save-exact flag.

These examples use remotion/index.ts as the entry file and MyComp as the composition ID; swap in your own.

Open Studio with npx remotion studio remotion/index.ts.

Then render it with npx remotion render remotion/index.ts MyComp out.mp4.

Here, you're supplying the entry file, choosing MyComp, and naming the output out.mp4 directly in the command.

Need another Remotion package? Add it with npx remotion add <package>.

terminal
npm i --save-exact remotion@4.0.542 @remotion/cli@4.0.542
npx remotion studio remotion/index.ts
npx remotion render remotion/index.ts MyComp out.mp4

Linux servers

Check the Linux requirements before you try rendering on a server: you need glibc 2.35 or newer. Alpine Linux and NixOS aren't supported.

On Ubuntu 24.04, install the libraries Chrome needs with the apt install command in the code box.

After installing the libraries, use the render command for your setup: npx remotion render for the new-project flow, or the command with your entry file and composition ID for an existing app.

ubuntu-24.04.sh
apt install -y \
  libnss3 libdbus-1-3 libatk1.0-0 libasound2t64 libxrandr2 \
  libxkbcommon-dev libxfixes3 libxcomposite1 libxdamage1 libgbm-dev \
  libcups2 libcairo2 libpango-1.0-0 libatk-bridge2.0-0

FAQ

Questions, answered

Can I use Bun instead of Node.js?

Mostly. Remotion lists Bun 1.0.3 or newer next to Node.js 16 or newer, and calls Bun as a runtime mostly supported.

Which template should I choose?

Hello World is the recommended start. The non-interactive --blank command gives you a blank project instead.

Do I need to pay for Remotion?

Remotion is free for individuals and companies of up to 3 people. Bigger companies need a Company License.

Do I have to specify a composition ID to render?

No. Run npx remotion render without a composition ID, and it lets you pick one.

Ready to build?

Ship video from your app today

Your first $0.50 is free, and one key covers every endpoint.

Moonlit lake with a lit cabin under the mountains