Reference
2 min read

Build image

Learn about base image for all Vercel builds.
Table of Contents

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-libat-spi2-atkatk
autoconfbsdtarbzip2
bzip2-develcups-libsexpat-devel
gccgcc-c++git
glib2-develglibc-develgtk3
gzipImageMagick-devellibXScrnSaver
libXcompositelibXcursorlibXi
libXrandrlibXtstlibffi-devel
libglvnd-glxlibiculibjpeg
libjpeg-devellibpnglibpng-devel
libstdc++libwebp-toolsmake
ncurses-libsopensslopenssl-devel
openssl-libspangoreadline-devel
ruby-develstracetar
unzipwhichzlib-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
Last updated on February 21, 2024