The new Cosmic dashboard is here!
Test drive it now →


Find answers to questions and get help with common issues.

I keep getting an error when trying to deploy my Node.js app.

If you are trying to deploy a Node.js app to the Cosmic App Server, you need to make sure:

  • It can be built in production mode.
  • It has an npm start script in the package.json file.
  • It has a dynamic PORT environment variable.

From your local repo root folder try running the following commands to test that your app can be deployed successfully:

rm -rf node_modules
npm install --production
PORT=5000 npm start

If your app builds successfully and is accessed from http://localhost:5000, then your app should be able to be deployed to the Cosmic App Server successfully.

If you are still having issues, the Heroku troubleshooting docs may also lend some help.

I keep getting an error when trying to deploy my empty code repository.

You can not deploy an empty repositiory. Make sure your repository is not empty and it follows the guidelines for Heroku app deployment for its specific programming language.

Other issues

Reach out to us in our Slack community or through the live chat feature on the bottom right of this page and we'll be happy to help you troubleshoot your specific issue.

Get Started with Cosmic

Build personal projects for free. Add your team at unbeatable prices.
Start Building Talk to Sales