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
Dockerfileto 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
Dockerfileunder 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.