Skip to main content

Linux Dependencies

If you are on Linux, Chrome Headless Shell requires some shared libraries to be installed.

Ubuntu 24.04

bash
apt install -y \
libnss3 \
libdbus-1-3 \
libatk1.0-0 \
libasound2t64 \
libxrandr2 \
libxkbcommon-dev \
libxfixes3 \
libxcomposite1 \
libxdamage1 \
libgbm-dev \
libatk-bridge2.0-0

Older versions of Ubuntu

bash
apt install -y \
libnss3 \
libdbus-1-3 \
libatk1.0-0 \
libasound2 \
libxrandr2 \
libxkbcommon-dev \
libxfixes3 \
libxcomposite1 \
libxdamage1 \
libgbm-dev \
libatk-bridge2.0-0

Debian

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

Amazon Linux 2023

bash
yum install -y \
mesa-libgbm \
libX11 \
libXrandr\
libdrm \
libXdamage \
libXfixes \
dbus -libs\
libXcomposite \
alsa -lib \
nss \
dbus \
at-spi2-core \
atk \
at-spi2-atk

Alpine Linux

Not supported due to to unsupported Libc symbols.

nixOS

Not supported because Remotion ships with its own binaries of Chrome and FFmpeg that are not baked into the operating system.
This conflicts with the "immutable distro" architecture of nixOS.