Build Image Installed Packages

The build image uses Amazon Linux 2023 as its base image. 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.

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

dnf alsa-lib at-spi2-atk atk autoconf automake 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 make nasm ncurses-libs ncurses-compat-libs openssl openssl-devel openssl-libs pango procps readline-devel ruby-devel strace 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

The build image (legacy) uses Amazon Linux 2 as its base image. Vercel will automatically use it for all deployments with the 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.

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

dnf alsa-lib at-spi2-atk atk autoconf automake 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 libyaml-devel make nasm ncurses-libs ncurses-compat-libs openssl openssl-devel openssl-libs openssl11 openssl11-libs pango procps readline-devel ruby-devel strace tar unzip which zlib-devel zstd --yes

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

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:

amazon-linux-extras install php7.4

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

amazon-linux-extras install rust1

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

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:

yum list

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

yum search my-package-here

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

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:

amazon-linux-extras

You can install extra packages with the following command:

amazon-linux-extras install my-package-here