Build image (legacy)

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.

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