

In some cases, a build may fail due to a warning message that would not cause a build failure when run locally. Related: documentation about repository permissions and linking. You generally need administrative privileges on the repository, owning organization, or both. Your GitHub, Bitbucket, or GitLab user account may not have the privilege level required to link the repo to Netlify, even if you can log in and access it from the Git host’s website. If your configuration file is located in a subdirectory, you will need to change your folder structure or set the site’s base directory to tell us which subdirectory to use. Note that by default the buildbot looks for the configuration file in the root of your repository. Once we find your configuration file, we’ll automatically use it before trying to run your build command.
Project not build in active configuration? vs for mac how to#
You can tell the buildbot to install the software you need by including the proper configuration file, like a Gemfile for Ruby programs like jekyll, or package.json for Node programs like gulp.Ĭheck out the dependency management doc for more details on how to tell us to install your toolchain. If your build fails with jekyll: command not found or gulp: command not found or anything in that pattern, it means that the software required for that command hasn’t been installed in your build. Once you’ve considered the most frequently encountered issues listed below, there is some additional reading linked at the bottom of this article which may help you debug in more depth or find answers to less commonly asked questions. That’s the leading cause of build failure. You can find the settings for these in the dependency management doc. If your build works locally, the next debugging step is to ensure the package versions we use to build match yours. This is a prerequisite to all of the below suggestions. In case your build fails on Netlify, first make sure it builds locally in your own development environment.


This article provides troubleshooting tips for failing builds in Netlify’s build service.
