Build image

Learn about the container image used for Vercel builds that use Node.js 20.
Table of Contents

The build image uses Amazon Linux 2023 as base image and Vercel will automatically use it for all deployments with the 22.x or 20.x Node.js version project settings.

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

Pre-installed packages
alsa-libat-spi2-atkatk
autoconfautomakebsdtar
bzip2bzip2-develcups-libs
expat-develgccgcc-c++
gitglib2-develglibc-devel
gtk3gzipImageMagick-devel
iproutejava-11-amazon-corretto-headlesslibXScrnSaver
libXcompositelibXcursorlibXi
libXrandrlibXtstlibffi-devel
libglvnd-glxlibiculibjpeg
libjpeg-devellibpnglibpng-devel
libstdc++libtoollibwebp-tools
makenasmncurses-libs
ncurses-compat-libsopensslopenssl-devel
openssl-libspangoprocps
readline-develruby-develstrace
tarunzipwhich
zlib-develzstd

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

terminal
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:

terminal
dnf list

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

terminal
dnf search my-package-here

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

terminal
dnf install -y my-package-here
Last updated on July 23, 2024