Skip to content
Last updated on March 10, 2023
4 min read

Vercel uses Amazon Linux 2 as a base image for all builds and several pre-installed packages.

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

Pre-installed packages
alsa-lib
at-spi2-atk
atk
autoconf
bsdtar
bzip2
bzip2-devel
cups-libs
expat-devel
gcc
gcc-c++
git
glib2-devel
glibc-devel
gtk3
gzip
ImageMagick-devel
libXScrnSaver
libXcomposite
libXcursor
libXi
libXrandr
libXtst
libffi-devel
libglvnd-glx
libicu
libjpeg
libjpeg-devel
libpng
libpng-devel
libstdc++
libwebp-tools
make
ncurses-libs
openssl
openssl-devel
openssl-libs
pango
readline-devel
ruby-devel
strace
tar
unzip
which
zlib-devel

To run the build image locally with Amazon Linux 2, use the following command:

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