Chromium flags

We allow you to set the following flags in Chromium and Google Chrome since Remotion 2.6.5:

--disable-web-security

This will most notably disable CORS among other security features.

note

Remotion will automatically append the --user-data-dir flag.

Enabling in Node.JS APIs

In getCompositions(), renderStill() and renderFrames(), you can pass chromiumOptions.disableWebSecurity.

Enabling via CLI

Pass --disable-web-security in a remotion render or remotion still command.

Enabling via config file

Use setChromiumDisableWebSecurity().

tsx
Config.Puppeteer.setChromiumDisableWebSecurity(true);

tsx
Config.Puppeteer.setChromiumDisableWebSecurity(true);

--ignore-certificate-errors

Results in invalid SSL certificates, such as self-signed ones being ignored.

Enabling in Node.JS APIs

In getCompositions(), renderStill() and renderFrames(), you can pass chromiumOptions.ignoreCertificateErrors.

Enabling via CLI

Pass --ignore-certificate-errors in a remotion render or remotion still command.

Enabling via config file

Use setChromiumIgnoreCertificateErrors().

tsx
Config.Puppeteer.setChromiumIgnoreCertificateErrors(true);

tsx
Config.Puppeteer.setChromiumIgnoreCertificateErrors(true);

--headless

By default true. Disabling it will open an actual Chrome window where you can see the render happen.

Enabling in Node.JS APIs

In getCompositions(), renderStill() and renderFrames(), you can pass chromiumOptions.headless.

Enabling via CLI

Pass --headless=false in a remotion render or remotion still command.

Enabling via config file

Use setChromiumHeadlessMode().

tsx
Config.Puppeteer.setChromiumHeadlessMode(false);

tsx
Config.Puppeteer.setChromiumHeadlessMode(false);

--gl

Select the OpenGL renderer backend for Chromium. Accepted values: angle, egl, swiftshader. Default: angle.

Enabling in Node.JS APIs

In getCompositions(), renderStill() and renderFrames(), you can pass chromiumOptions.gl.

Enabling via CLI

Pass --gl=swiftshader in a remotion render or remotion still command.

Enabling via config file

tsx
Config.Puppeteer.setChromiumOpenGlRenderer("swiftshader");

tsx
Config.Puppeteer.setChromiumOpenGlRenderer("swiftshader");