Out Plane
Troubleshooting

Build Failed

Diagnose and fix a deployment that fails during the build.

When a deployment fails while building, open the deployment in the Deployments tab and read its build log. The error is almost always near the end.

Common Causes

  • Missing dependencies or lockfile. Commit your lockfile so the build installs the same versions you use locally.
  • Wrong build method. If you expect your Dockerfile to be used, set the build method to Dockerfile. To build without one, use Buildpacks. See Build Configuration.
  • Dockerfile not found. Out Plane looks for the Dockerfile under the root directory. In a monorepo, set the root directory to the app's folder.
  • A build step fails. A failing compile, test, or build script stops the build. Fix it so it passes locally first.

Build Filters

If a push did not build at all, check your build filters. Ignore rules win over allow rules. A manual deploy ignores filters, which is a quick way to force a build.

On this page