Skip to content
Build Image
3 min read

Build image

Table of Contents
Choose a framework to optimize documentation to:

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

    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

    Running the build image locally

    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.

    Installing additional packages

    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.

    Installing php in the build image

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

    terminal
    amazon-linux-extras install php7.4

    Installing Rust in the build image

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

    terminal
    amazon-linux-extras install rust1

    Installing Go in the build image

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

    terminal
    amazon-linux-extras install golang1.11

    Learn more about Amazon Linux Extras.

    Installing something else in the build image

    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 September 29, 2023
    Previous
    Build Features
    Next
    Build Logs
    Choose a framework to optimize documentation to: