645

I have my first node.js app (runs fine locally) - but I am unable to deploy it via heroku (first time w/ heroku as well). The code is below. SO doesn't let me write so much code, so I would just say that the running the code locally as well within my network shows no issue.

 var http = require('http');
 var fs = require('fs');
 var path = require('path');

 http.createServer(function (request, response) {

    console.log('request starting for ');
    console.log(request);

    var filePath = '.' + request.url;
    if (filePath == './')
        filePath = './index.html';

    console.log(filePath);
    var extname = path.extname(filePath);
    var contentType = 'text/html';
    switch (extname) {
        case '.js':
            contentType = 'text/javascript';
            break;
        case '.css':
            contentType = 'text/css';
            break;
    }

    path.exists(filePath, function(exists) {

        if (exists) {
            fs.readFile(filePath, function(error, content) {
                if (error) {
                    response.writeHead(500);
                    response.end();
                }
                else {
                    response.writeHead(200, { 'Content-Type': contentType });
                    response.end(content, 'utf-8');
                }
            });
        }
        else {
            response.writeHead(404);
            response.end();
        }
    });

 }).listen(5000);

 console.log('Server running at http://127.0.0.1:5000/');

Any idea ?

1
  • Can you post your code here? Preferably the .listen() part if you're starting an http server Mar 28, 2013 at 22:21

39 Answers 39

1383

Heroku dynamically assigns your app a port, so you can't set the port to a fixed number. Heroku adds the port to the env, so you can pull it from there. Switch your listen to this:

.listen(process.env.PORT || 5000)

That way it'll still listen to port 5000 when you test locally, but it will also work on Heroku. Important note - PORT word must be capital.

You can check out the Heroku docs on Node.js here.

8
  • 187
    important that you use process.env.PORT and not process.env.port.
    – gprasant
    Feb 25, 2014 at 14:15
  • 3
    Here's an example: github.com/heroku/node-js-getting-started/blob/master/index.js
    – Pablo
    Apr 28, 2016 at 11:39
  • Also, do no attempt to set the port as an environment variable with heorku config:set PORT=... as that is doomed to fail. Other environment variables can be set this way, but the PORT is not surprisingly unsupported (if only I RTFM first).
    – Boaz
    Jun 5, 2018 at 8:34
  • 11
    You'll also need to make sure the host is set to 0.0.0.0 Oct 31, 2020 at 6:19
  • 3
    Do ensure that you have process.env.PORT || 5000 and not 5000 || process.env.PORT. Spent quite some time before realizing my silly mistake... Aug 19, 2021 at 15:45
88

It's worth mentioning that if your code doesn't specify a port, then it shouldn't be a web process and probably should be a worker process instead.

So, change your Procfile to read (with your specific command filled in):

worker: YOUR_COMMAND

and then also run on CLI:

heroku scale worker=1
7
  • 2
    I had same issue I could resolved issue with replace 'localhost' with IP which is '0.0.0.0' Jul 16, 2017 at 18:54
  • 8
    I'm running a Discord bot on Heroku, and this threw me for a loop. Slack, Hipchat, etc. bots could likely have similar issues.
    – Skylar
    Aug 29, 2017 at 4:12
  • 3
    If you go this route, make sure to go to the Resources tab, turn off the web process and turn on the worker process. That way Heroku won't expect a port binding. Sep 28, 2018 at 16:29
  • 1
    Ohh thank you so much. I went nuts trying to look this up. I had no idea web and worker applications differed in Heroku in terms of the Procfile. It is worth mentioning that they needed me to add a start script in my package.json
    – Rishav
    Mar 6, 2019 at 16:19
  • 3
    In my case i changed the procfile from web to worker. It worked!! Thkns
    – rodrigorf
    Nov 13, 2019 at 15:26
60

For those that are passing both a port and a host, keep in mind that Heroku will not bind to localhost.

You must pass 0.0.0.0 for host.

Even if you're using the correct port. We had to make this adjustment:

# port (as described above) and host are both wrong
const host = 'localhost';
const port = 3000;

# use alternate localhost and the port Heroku assigns to $PORT
const host = '0.0.0.0';
const port = process.env.PORT || 3000;

Then you can start the server, as usual:

app.listen(port, host, function() {
  console.log("Server started.......");
});

You can see more details here: https://help.heroku.com/P1AVPANS/why-is-my-node-js-app-crashing-with-an-r10-error

4
  • 7
    This answer is not only more complete, but the only one that targeted the two possible problems. In my case the port configuration was correct, but not the listening address. This should be the accepted answer.
    – Danielo515
    Feb 12, 2018 at 6:11
  • In my case it works as I changes as below const port = 3000; to const port = process.env.PORT || 3000; it works on heroku
    – vpgodara
    Jan 6, 2019 at 4:42
  • 3
    Omg, I can't believe how this is isn't mentioned anywhere in the docs. I even tried to let Heroku pass their own process.env.HOST but that didn't work as well. At first I was setting it as localhost thinking that Heroku sets up some sort of a reverse proxy. Not only this isn't documented, but the answer had to be the fourth one on Stackoverflow. Sometimes I wonder why I chose this career path :( Jul 23, 2020 at 20:12
  • THANK YOU!!! it would be great if this was FRONT AND CENTER in the heroku docs 😂 Feb 24, 2022 at 1:50
58

The error happens when Heroku failed to bind the port or hostname at server.listen(port, [host], [backlog], [callback]).

What Heroku requires is .listen(process.env.PORT) or .listen(process.env.PORT, '0.0.0.0')

So more generically, to support other environments, use this:

var server_port = process.env.YOUR_PORT || process.env.PORT || 80;
var server_host = process.env.YOUR_HOST || '0.0.0.0';
server.listen(server_port, server_host, function() {
    console.log('Listening on port %d', server_port);
});
1
  • 9
    With following call: app.listen(serverPort, "localhost", function (err) { Heroku was failing. Switching "localhost" to "0.0.0.0" helped. Thanks!
    – pubsy
    Aug 29, 2017 at 21:02
29

I had same issue while using yeoman's angular-fullstack generated project and removing the IP parameter worked for me.

I replaced this code

server.listen(config.port, config.ip, function () {
  console.log('Express server listening on %d, in %s mode', config.port, app.get('env'));
});

with

server.listen(config.port, function () {
  console.log('Express server listening on %d, in %s mode', config.port, app.get('env'));
});
1
  • This worked for me! Can you please explain why this works? Jul 25, 2020 at 6:29
12

In my case, I was using example from https://hapijs.com/

To fix the problem I replaced

server.connection({ 
    host: 'localhost', 
    port: 8000 
});

with

server.connection({
    port: process.env.PORT || 3000 
});
1
12

change this line

app.listen(port);

to

app.listen(process.env.PORT, '0.0.0.0');

it will work

1
  • This works for me. I am using fastify
    – Binh Ho
    Sep 23, 2021 at 6:06
10

While most of the answers here are valid, for me the issue was that I was running long processes as part of npm run start which caused the timeout.

I found the solution here and to summarize it, I just had to move npm run build to a postinstall task.

In other words, I changed this:

"start": "npm run build && node server.js"

to this:

"postinstall": "npm run build",
"start": "node server.js"

Come to think of this, it totally makes sense because this error (which used to appear occasionally) was becoming more and more common as my app kept growing.

2
  • 1
    Had a similar problem: I was running my build on prestart:prod script then moved to postinstall script Jan 4, 2021 at 14:42
  • There was no start script so I only had to add that. And it worked, thanks.
    – Wylie
    Mar 29, 2022 at 12:01
6

Changing my listening port from 3000 to (process.env.PORT || 5000) solved the problem.

4

Restarting all dynos in heroku did the trick for me

enter image description here

3

In my case, I was using Babel with the babel-plugin-transform-inline-environment-variables plugin. Apparently, Heroku does not set the PORT env variable when doing a deployment, so process.env.PORT will be replaced by undefined, and your code will fallback to the development port which Heroku does not know anything about.

3

I realized that I don't need the port number in the request endpoint, so the endpoint was herokuapp.com and not herokuapp.com:5000.

The listen() call can be without host and callback:

server.listen(5000);
1
  • You don't need the port number in the URL if you use the default port. So how does that solve the problem?
    – RalfFriedl
    Oct 7, 2019 at 18:33
3

I Use ReactJs, If you want upload to heroku add this in your webpack.config.js

Because if not add you will have error

Error R10 (Boot timeout) -> Web process failed to bind to $PORT within 60 seconds of launch

//webpack.config.js add code like that

const HtmlWebPackPlugin = require("html-webpack-plugin");
const MiniCssExtractPlugin = require("mini-css-extract-plugin");
var server_port = process.env.YOUR_PORT || process.env.PORT || 5000;
var server_host = process.env.YOUR_HOST || "0.0.0.0";

module.exports = {
  module: {
    rules: [
      {
        test: /\.js$/,
        exclude: /node_modules/,
        use: {
          loader: "babel-loader"
        }
      },
      {
        test: /\.css$/,
        use: [MiniCssExtractPlugin.loader, "css-loader"]
      }
    ]
  },
  devServer: {
    disableHostCheck: true,
    contentBase: "./ dist",
    compress: true,
    inline: true,
    port: server_port,
    host: server_host

  },
  plugins: [
    new HtmlWebPackPlugin({
      template: "./src/index.html",
      filename: "index.html"
    }),
    new MiniCssExtractPlugin({
      filename: "[name].css",
      chunkFilename: "[id].css"
    })
  ]
};
3

I had the same issue because I didn't define Procfile. Commit a text file to your app's root directory that is named Procfile without a file extension. This file tells Heroku which command(s) to run to start your app.

web: node app.js
1
  • Thanks, I forgot doing this. Without this file, the heroku just ignores the files completely. May 21, 2020 at 14:25
2

Edit package.json:

...
"engines": {
"node": "5.0.0",
"npm": "4.6.1"
},
...

and Server.js:

...
var port = process.env.PORT || 3000;
app.listen(port, "0.0.0.0", function() {
console.log("Listening on Port 3000");
});
...
1
  • In my case I took out that part of the package.json. I believe updating it should also solve this problem.
    – Mark
    Jan 17, 2018 at 19:06
2

I've spent a lot of hours to find the root cause, and eventually I've found that this timeout (60s) can be adjustable. Here you may change 60 second to 120 or even more. It works for me, hope will help anybody else!

2

To resolve this follow these Four simple steps: in the package.json file:

1- set the main field to the server file:

"main": "server.js" // <-- here set you server file

2- add the host parameter to the app.listen function

const port = process.env.PORT || 3000;
const host = '0.0.0.0'
app.listen(port, host, ()=> connsole.log(`server is running on port ${port}`)

3- add the postinstall script to package.json file

"scripts": {
     "postinstall": "npm run build", // <-- add this line
     "start": "node server.js" // <-- change server.js to you main file
}

4- add the engines field in package.json file

"engines": {
   "node": ">=14.0.O", // <-- change it to your node version. you can "node -v" in you command line
   "npm": ">=7.7.0" // <-- change this to your npm version. you can use "npm -v" in the command line to get your npm version
}

let me know if you have any succes with this!

0
2

Use process.env.PORT || 3000 for your port.

This will use Heroku's port when available or use port 3000 if it's not available (for example, local testing)

You can change 3000 to whatever you want, for example 8080

1
  • 1
    In my scenario, I got the same error. However, my server.js file had only 3000 as the port. But once I have added the port for the Heroku which is process.env.PORT, I was able to properly deploy the app. Thanks.
    – VOSH
    Oct 23, 2021 at 10:19
2

In your package.json file, in the scripts, make sure your start script contains -p $PORT.

Example of package.json (in this case, for NextJS app):

{
  "private": true,
  "scripts": {
    "dev": "next dev -p 3001",
    "build": "next build",
    "start": "next start -p $PORT" // make sure to have -p $PORT in here
  },
  "dependencies": {
    "typescript": "^4.3.2"
  },
  "devDependencies": {
    "@next/eslint-plugin-next": "^11.1.2",
    "@types/mongoose": "^5.11.97"
    "typescript": "^4.3.2"
  }
  "license": "MIT"
}

1

I had same issue I could resolved issue with replace 'localhost' with IP which is '0.0.0.0'

1

In my case, neither the port nor the host was the problem. The index.js was divided into 2 files. server.js:

//server.js
const express = require('express')
const path = require('path')

const app = express()

app.use(express.static(path.resolve(__dirname, 'public')));
// and all the other stuff
module.exports = app

//app.js
const app = require('./server');
const port = process.env.PORT || 3000;
app.listen(port, '0.0.0.0', () => {
    console.log('Server is running s on port: ' + port)
});

from package.json we ran node app.js.

Apparently that was the problem. Once I combined the two into one file, the Heroku app deployed as expected.

1

I have the same issue but my environment variables are set well and the version of npm and node is specified in package.json. I figured out it is because, in my case, Heroku needs "start" to be specified in package.json:

  "scripts": {
    "start": "node index.js"
  }

After adding this to my package.json my node app is successfully deployed on Heroku.

1

While developing the application we need to define the PORT in the following way:

const port = process.env.PORT || 4000; // PORT must be in caps

And while deploying the app to server add the following method:

app.listen(port, () => {
 console.info("Server started listening.");
});

We can pass hostname as second parameter while running it in local. But while deploying it to server the hostname parameter should be removed.

app.listen(port, hostName, () => {
  console.info(`Server listening at http://${hostName}:${port}`);
});
1

My case was that I was running Database scripts on start up and were taking long time. I solved this by manually running npm start after deployment is complete.

1

I was working with a Vue app using vite when I ran into this issue. My npm run start command was defined as:

"scripts": {
  "start": "vite --port 8080",
}

The explanation has been overdue on this answer thread but I just thought to provide the syntax of the solution in case anybody else is looking for it:

"start": "vite --host '0.0.0.0' --port $PORT",
0

A fixed number can't be set for port, heroku assigns it dynamically using process.env.PORT. But you can add them both, like this process.env.PORT || 5000. Heroku will use the first one, and your localhost will use the second one.

You can even add your call back function. Look at the code below

app.listen(process.env.PORT || 5000, function() {
    console.log("Server started.......");
});
0

At of all the solution i have tried no one work as expected, i study heroku by default the .env File should maintain the convention PORT, the process.env.PORT, heroku by default will look for the Keyword PORT.

Cancel any renaming such as APP_PORT= instead use PORT= in your env file.

0

From the heroku bash process, pass down the value of $PORT to your node app using an options parser like yargs.

Here is an example of how you might do that. On the scripts object, inside package.json, add a start method "node server --port $PORT".

In your server file, use yargs to get the value from the port option (--port $PORT) of the start method:

const argv = require('yargs').argv;
const app = require('express')();

const port = argv.port || 8081;

app.listen(argv.port, ()=>{
    console.log('Probably listening to heroku $PORT now ', argv.port); // unless $PORT is undefined, in which case you're listening to 8081.
});

Now when your app starts, it will bind to the dynamically set value of $PORT.

0

If, like me, you're configuring Heroku to run a script from your package.json file on deploy, make sure you haven't hard-coded the value of PORT in that script! If you do, you'll end up like me and spend an hour trying to figure out why you're getting this error.

0

I had same issue but with express and apollo-server. The solution from here:

The only special consideration that needs to be made is to allow heroku to choose the port that the server is deployed to. Otherwise, there may be errors, such as a request timeout.

To configure apollo-server to use a port defined by Heroku at runtime, the listen function in your setup file can be called with a port defined by the PORT environment variable:

> server.listen({ port: process.env.PORT || 4000 }).then(({ url }) => { 
> console.log(`Server ready at ${url}`); });

Not the answer you're looking for? Browse other questions tagged or ask your own question.