--- title: build_failed description: Your source did not build. --- # `build_failed` **Severity:** error. Your source did not build. ## What happened Kaviris tried to build your app and the build stopped with an error. The refusal's `what` holds the last lines of the build log. ## How to fix it Read the build log: ```sh kaviris logs ``` (Agents: `get_logs` with the deploy id.) Common causes: - a dependency missing from `package.json` / `requirements.txt`, or a lockfile that doesn't match it (run the install locally and commit the lockfile); - a build that needs an environment variable at build time; - files missing from the upload because they are in `.gitignore` or were not committed; - files left out of the build by your `.dockerignore`, which Kaviris honours even though it builds without your Dockerfile. A project made to ship a ready-built image may ignore what its build needs (an error like `Cannot resolve entry module index.html`): take those lines out. The version running now keeps serving while you fix it. Make sure the project builds on your own machine with a clean install, fix, and deploy again. [All refusal codes](index.md)