Troubleshooting

Troubleshooting Tips

Build Troubleshooting Tips

  • Do not name your build command build. This will cause internal issues when building your project.
  • If your build fails, the first thing you should check is if you are able to build your file locally in the development environment.
  • If it builds successfully locally, then you should check if the dependencies installed by Terminal are the same as the ones being used locally.

Command not found

  • If your build fails with command not found, then your dependencies have not been installed. To install your dependencies, upload a configuration file such as package.json for NodeJS programs listing all of the require dependencies.

Build fails with 'exit status 128'

  • If your build is failing with exit status 128, this likely means that we no longer have access to your GitHub repository. Ensure that your repo is public or that you gave us access by signing in through GitHub when providing the link to the repo.

Large files or sites

  • Sites with many thousands of html files can often take a significant amount of time to deploy
  • Our CDN does not support files of 10 MB or greater

Enqueued builds

  • System queue
    • This occurs when the number of builds across all of our customers exceeds our current network capacity. When this happens builds will be queued as they come in and being deploying when other builds finish
  • Team queue
    • This occurs when the number of total builds across all of your sites exceeds the build limit. You can increase your concurrent builds by upgrading your account or by contacting support. If you have this issue, you can cancel other builds that may not be as important.

We are here to help

We are happy to help get your website up and running. Please feel free to reach out on our website, in our Community Chat, on Twitter, or at [email protected]