Build image overview

When you initiate a deployment, Vercel will build your project within a container using the build image. Vercel supports multiple runtimes.

The build image uses Amazon Linux 2023 as its base image.

The following packages are pre-installed in the build image with dnf, the default package manager for Amazon Linux 2023.

You can install these packages using the dnf package manager with the following command:

1
dnf alsa-lib at-spi2-atk atk autoconf automake brotli bsdtar bzip2 bzip2-devel cups-libs expat-devel gcc gcc-c++ git glib2-devel glibc-devel gtk3 gzip ImageMagick-devel iproute java-11-amazon-corretto-headless libXScrnSaver libXcomposite libXcursor libXi libXrandr libXtst libffi-devel libglvnd-glx libicu libjpeg libjpeg-devel libpng libpng-devel libstdc++ libtool libwebp-tools libzstd-devel make nasm ncurses-libs ncurses-compat-libs openssl openssl-devel openssl-libs pango procps perl readline-devel ruby-devel strace sysstat tar unzip which zlib-devel zstd --yes

Vercel does not provide the build image itself, but you can use the Amazon Linux 2023 base image to test things locally:

docker run --rm -it amazonlinux:2023.2.20231011.0 sh

When you are done, run exit to return.

You can install additional packages into the build container by configuring the Install Command within the dashboard or the "installCommand" in your vercel.json to use any of the following commands.

The build image includes access to repositories with stable versions of popular packages. You can list all packages with the following command:

dnf list

You can search for a package by name with the following command:

dnf search my-package-here

You can install a package by name with the following command:

dnf install -y my-package-here