Fix EADDRINUSE Port Already in Use Error in Node.js

The EADDRINUSE error happens when your Node.js app tries to use a port that another process is already using. To fix it, either stop the other process using that port or change your app to listen on a different free port.

Why This Happens

This error occurs because your Node.js server tries to listen on a port that is already taken by another program or another instance of your app. Ports are like doors for your computer to communicate over the network, and only one program can use a door at a time.

javascript

const http = require('http');

const server = http.createServer((req, res) => {
  res.end('Hello World');
});

server.listen(3000, () => {
  console.log('Server running on port 3000');
});

// Running this code twice without stopping the first will cause EADDRINUSE error

Output

Error: listen EADDRINUSE: address already in use 127.0.0.1:3000
    at Server.setupListenHandle [as _listen2] (net.js:1300:16)
    at listenInCluster (net.js:1348:12)
    at Server.listen (net.js:1436:7)
    at Object.<anonymous> (/path/to/app.js:8:8)
    at Module._compile (internal/modules/cjs/loader.js:999:30)
    at Object.Module._extensions..js (internal/modules/cjs/loader.js:1027:10)
    at Module.load (internal/modules/cjs/loader.js:863:32)
    at Function.Module._load (internal/modules/cjs/loader.js:708:14)
    at Function.executeUserEntryPoint [as runMain] (internal/modules/run_main.js:60:12)
    at internal/main/run_main_module.js:17:47

The Fix

To fix this error, you can either stop the process that is using the port or change your Node.js app to listen on a different port that is free. You can also add error handling to detect this problem and respond gracefully.

javascript

const http = require('http');

const PORT = 3001; // Changed port to avoid conflict

const server = http.createServer((req, res) => {
  res.end('Hello World');
});

server.listen(PORT, () => {
  console.log(`Server running on port ${PORT}`);
});

server.on('error', (err) => {
  if (err.code === 'EADDRINUSE') {
    console.error(`Port ${PORT} is already in use. Please use a different port.`);
  } else {
    console.error(err);
  }
});

Output

Server running on port 3001

Prevention

To avoid this error in the future, always check if the port is free before starting your server. Use tools like lsof or netstat to find processes using ports. Also, consider using environment variables to set ports dynamically and add error handling in your code to catch port conflicts early.

• Use process.env.PORT to allow flexible port assignment.
• Stop previous server instances before restarting.
• Use scripts or tools to kill processes blocking ports.

Related Errors

Other common network errors include:

• ECONNREFUSED: When your app tries to connect to a server that is not running.
• ETIMEDOUT: When a connection attempt takes too long and times out.
• EACCES: When your app lacks permission to use a port (usually ports below 1024).

Fixes usually involve checking server status, permissions, and network settings.

Key Takeaways

EADDRINUSE means the port is already taken by another process.

Stop the other process or change your app to use a free port to fix it.

Add error handling to detect port conflicts and respond gracefully.

Use environment variables to set ports flexibly and avoid hardcoding.

Check running processes with tools like lsof or netstat before starting your server.