Troubleshooting Guide: Fixing Failed to Make TCP Connection to Port 8080 Connection Refused Error

This guide provides a step-by-step solution to troubleshoot and fix the "Failed to make TCP connection to port 8080: Connection refused" error. This error typically occurs when your application tries to establish a TCP connection to a specific port, but the connection is refused.

Table of Contents


Before we begin troubleshooting, ensure you have the following:

  • Administrator access to the system experiencing the issue.
  • Basic understanding of TCP/IP networking.

Step 1: Verify Port Availability

Ensure that the port 8080 is not being used by another application. You can check this using the netstat command.

On Linux:

sudo netstat -tuln | grep 8080

On Windows:

netstat -a -n -o | findstr "8080"

If the port is already in use, either change the port in your application's configuration or stop the application using the port.

Learn more about netstat command

Step 2: Check Firewall Settings

Verify if a firewall is blocking the connection to port 8080. Temporarily disable the firewall to check if it resolves the issue.

On Linux:

sudo ufw disable

On Windows:

Set-NetFirewallProfile -Profile Domain,Public,Private -Enabled False

If disabling the firewall resolves the issue, create a rule to allow inbound connections to port 8080.

Learn more about configuring firewall on Linux

Learn more about configuring firewall on Windows

Step 3: Inspect Application Configuration

Review your application's configuration to ensure the correct port and IP address are specified. Check if the application is configured to listen on port 8080 and bind to the correct IP address.

Related link: Configuring IP addresses and port numbers in applications

Step 4: Examine Network Configuration

Examine the network configuration and ensure that port forwarding and network address translation (NAT) are properly configured on your router or other network devices.

Learn more about port forwarding and NAT

Step 5: Verify Service Status

Ensure that the application or service listening on port 8080 is running. Restart the service if necessary.

On Linux (using systemctl):

sudo systemctl restart your-service-name

On Windows:

Restart-Service -Name "YourServiceName"

Learn more about managing services on Linux

Learn more about managing services on Windows


What is a TCP connection?

TCP, or Transmission Control Protocol, is a communication protocol used to establish a reliable and ordered data transmission between devices over an IP network. A TCP connection is a connection established between two devices using this protocol.

Why am I getting a 'Connection Refused' error?

A 'Connection Refused' error occurs when the target device actively refuses the connection attempt from the source device. This can be caused by various reasons, such as the target device not having any service listening on the specified port, a firewall blocking the connection, or incorrect network configuration.

Can I use a different port instead of 8080?

Yes, you can use any available port on your system. However, ensure that the port you choose does not conflict with other services and is allowed by your firewall.

How do I change the port my application is listening on?

This depends on the specific application you are using. Check the application's documentation for instructions on changing the listening port.

What should I do if the error persists after following the troubleshooting steps?

If the error persists after following the troubleshooting steps, consider seeking assistance from the application's support team or reaching out to a relevant online forum.

Great! You’ve successfully signed up.

Welcome back! You've successfully signed in.

You've successfully subscribed to

Success! Check your email for magic link to sign-in.

Success! Your billing info has been updated.

Your billing was not updated.