Reference
2 min read

Build image (legacy)

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

The build image (legacy) uses Amazon Linux 2 as base image and Vercel will automatically use it for all deployments with the 16.x or 18.x Node.js version project setting.

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

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
libyaml-develmakenasm
ncurses-libsncurses-compat-libsopenssl
openssl-developenssl-libsopenssl11
openssl11-libspangoprocps
readline-develruby-develstrace
tarunzipwhich
zlib-develzstd

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

terminal
docker run --rm -it amazonlinux:2.0.20191217.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.

To add php to your path, run the following command:

terminal
amazon-linux-extras install php7.4

To add cargo to your path, run the following command:

terminal
amazon-linux-extras install rust1

To add go to your path, run the following command:

terminal
amazon-linux-extras install golang1.11

Learn more about Amazon Linux Extras.

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

terminal
yum list

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

terminal
yum search my-package-here

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

terminal
yum install my-package-here -y

You can use Amazon Linux Extras if you need a new or newer version of an existing software package that is not included in the default repositories.

You can list extra packages with the following command:

terminal
amazon-linux-extras

You can install extra packages with the following command:

terminal
amazon-linux-extras install my-package-here
Last updated on May 23, 2024