Build Image Overview

Author:Esadax
Updated:Mar 8, 2025

When you initiate a deployment on Esadax, your project is built within a container that uses a predefined image. This build image is determined by the Node.js version specified in your project settings.

Table of Contents

  1. Understanding Build Images
  2. Determining the Build Image
  3. Runtime Support
  4. Build Image (Legacy)
  5. Troubleshooting Builds

Understanding Build Images

A build image is a container image that provides the necessary environment and dependencies for building your application. Esadax supports multiple runtimes, each corresponding to different versions of Node.js.

Determining the Build Image

The build image used by Esadax is based on the Node.js version selected in your project settings:

  • Node.js 22.x: Uses Amazon Linux 2023.
  • Node.js 20.x: Uses Amazon Linux 18.x.
  • Node.js 18.x: Uses Amazon Linux 16.x.
  • Node.js 16.x: Uses the legacy build image (Amazon Linux 2).

Runtime Support

Esadax supports multiple runtimes, with versions varying by the selected build image:

Runtime Build Image Build Image (Legacy)
Node.js 22.x 20.x
Node.js 20.x 18.x
Node.js 18.x 16.x
Node.js 16.x
Edge 3.12 3.9
Python 3.9 3.6
Ruby 3.3.x 3.2.x
Go Community Runtimes

Build Image (Legacy)

The legacy build image (Amazon Linux 2) supports:

  • Node.js versions: 16.x, 18.x, 20.x, and 22.x.
  • Python versions: 3.6 and 3.9.

Troubleshooting Builds

If you encounter issues with builds, refer to the Build Features section for troubleshooting tips.