Deployment fails with “Error building project: The build hook failed with status code 1”

Last update: March 17, 2025

CREATED FOR:

  • Developer

This article talks about the causes and solutions for the Adobe Commerce on cloud infrastructure issue, where the build phase of the deployment process fails, and the error message is summarized with: “Error building project: The build hook failed with status code 1”.

Affected products and versions

  • Adobe Commerce on cloud infrastructure, all versions

Issue

Steps to reproduce:

Trigger the deployment manually or by performing a merge, push, or synchronization of your environment.

Expected result:

Deployment is completed successfully.

Actual result:

  1. The building phase fails, and the whole deployment process gets stuck.
  2. In the deployment error log, the error message ends with: “Error building project: The build hook failed with status code 1. Aborted build”.

Cause

There are multiple reasons why environment building fails. Usually, in the deployment log, you will see a long error message, where the first part would be more specific regarding the reason, and the conclusion would be “Error building project: The build hook failed with status code 1. Aborted build”.

Looking closer at the first problem-specific part will help you to identify the issue. Here are the most common ones, and the next section provides solutions for them:

  • There is no available storage space.
  • Incorrect ECE-Tools configuration.
  • The patch you are trying to apply is incompatible with your Adobe Commerce version or has conflicts with other patches applied or your customizations.
  • Problems with custom modules code are preventing from building successfully.

Solution

  • Check to ensure that there is enough storage. For information on how to check available space, see the Check disk space on cloud environment using CLI article. You can consider cleaning the log directories and/or increasing disk space.
  • Ensure ECE-Tools are configured correctly.
  • Check if it is the patch that is causing the problem. Resolve the conflict or contact Adobe Commerce Support. See below for details.
  • Check if it is the custom extension that is causing the problem. Resolve the conflict or contact the extension developers for the solution.

The following paragraphs provide some more details.

Clean logs and/or increase space

Directories to be considered for clean up:

  • var/log
  • var/report
  • var/debug/
  • var

For details on how to increase disk space if you are on the Adobe Commerce on cloud infrastructure Starter plan architecture, see the Increase disk space for Integration environment on cloud. The same instructions can be used for increasing space of Adobe Commerce on cloud infrastructure Pro plan architecture Integration environment. For Pro Production/Staging, you need to file a ticket to Adobe Commerce Support, and request increased disk space. But it is monitored by Platform. But typically, you will not have to deal with this on the Staging/Production of Pro architecture as Adobe Commerce monitors these parameters for you and alerts you and/or takes actions according to the contract.