Driver FixRecommendedSound, Wi-Fi or graphics acting up? Check drivers firstFind missing or outdated drivers fast.Check DriversHalloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsWindows FixRecommendedWindows errors stealing your time? Find the fix fastScan stability, cleanup and performance issues.Fix Now×
Skip to content
World desk11 min

Tomcat Not Responding After a Port Change: How to Fix It

Tomcat usually stops responding after a port edit because the wrong server.xml was changed, the new port is occupied, the instance was not restarted, or clients still use the old URL. This guide traces each cause and shows how to recover safely.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

If Tomcat stopped responding after you edited server.xml, check four things in order: you changed the configuration used by the running instance, the new port is free, Tomcat was restarted, and your client is requesting the new host:port. The HTTP connector, HTTPS connector, and shutdown port are separate settings, so changing the wrong one can leave the web endpoint unchanged. If the new socket answers but your application returns an error, investigate its context path and deployment rather than changing the port again.

Start with the failure you can actually observe

Port changes produce different symptoms, and each symptom points to a different layer. Classify the failure before editing more XML.

As an Amazon Associate I earn from qualifying purchases.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Observed symptom Likely layer First action
Tomcat fails during startup and the log contains Address already in use, bind, or connector-initialization errors Port ownership Find the process holding the selected port, stop it if appropriate, or choose another unused port.
Tomcat starts, but the browser still reports connection refused on the former port Client URL Request the new port; bookmarks, health checks, proxies, and API clients do not update themselves.
A request from the Tomcat host works, but a request from another machine fails Network path Check the connector bind address, host firewall, cloud security group, container publishing, proxy, and load balancer.
HTTP works but an HTTPS URL or redirect fails Secure connector pairing Review the HTTPS connector and the non-SSL connector’s redirectPort, then restart.
The Tomcat landing page appears, but the application returns 404 Webapp context or deployment Use the deployed context path and verify that the WAR or exploded application actually deployed.
One Tomcat instance starts while another cannot Overlapping server or connector ports Compare every instance’s shutdown and connector ports, including any portOffset.

A refused connection means no process is accepting the socket at the address you tested. An HTTP status such as 404 or 500 proves that a process answered; continue with application and deployment checks instead of treating it as a port-bind failure.

Identify the port setting that controls your URL

For ordinary HTTP, the relevant value is the port attribute on the active HTTP Connector. A typical connector looks like this:

#1 Best Overall
Sale
TOZO A1 Wireless Earbuds Bluetooth 5.3 Light Weight in Ear Headphones | IPX5 Waterproof,2 Mics for AI Calls,Immersive Premium Sound Bass Headset with Charging Case,32 EQ via App Black
  • [Ultra-Lightweight Ear Buds Designed for Small Ears] Each earbud weighs only 3.7g and features a compact, ergonomic in-ear design made especially for small ears. Secure, low-profile, and comfortable for workouts, all-day wear or overnight sleeping.The ultra-slim profile sits flush in your ear with no hard edges poking or rubbing, so you can even sleep on your side without discomfort.
  • [Immersive Stereo Sound with TOZO OrigX Technology] TOZO OrigX tuning delivers clear vocals, balanced mids, and natural stereo sound for music, podcasts, and videos.
  • [Long Battery Life for Daily Use] Get up to 7 hours of playtime on a single charge, with up to 32 hours total using the charging case—ideal for workdays, commuting, and extended listening sessions.
  • [Bluetooth 5.3 & Stable Connection] Bluetooth 5.3 provides fast pairing, stable wireless performance, and reduced dropouts as you move around home or office.
  • [Deep Bass with Clear Vocals] High-performance drivers produce punchy bass while keeping vocals clean and detailed for everyday listening.
<Connector port='8080' protocol='HTTP/1.1'
           connectionTimeout='20000'
           redirectPort='8443' />

Tomcat creates its HTTP server socket on that connector port. The usual default is 8080; that is a configuration default, not a requirement. If you changed it to 1977, an HTTP request must use http://localhost:1977/ when testing locally.

Make sure you edited the running instance

Tomcat installations can have separate CATALINA_HOME and CATALINA_BASE directories. CATALINA_HOME contains the installed binaries, while CATALINA_BASE identifies an instance’s configuration, logs, webapps, and work directories. In a single-instance installation they may be the same directory. A service, container, IDE, or startup script can point to a different base directory than the one you opened in an editor.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Inspect the startup command, service definition, or container environment to determine the active base directory. Then open its conf/server.xml. Editing a second Tomcat installation has no effect on the process that is listening.

Distinguish HTTP, HTTPS, and shutdown ports

Setting Where it appears What it does What you test
HTTP connector <Connector ... protocol='HTTP/1.1' ...> Accepts unencrypted web requests http://host:port/
HTTPS connector A connector configured with SSL/TLS attributes Accepts encrypted web requests https://host:secure-port/
Shutdown port The outer <Server port='...'> element Receives Tomcat’s shutdown command; it is not a browser endpoint Do not use it as the HTTP URL

The redirectPort on a non-SSL connector tells Tomcat where to send requests that require transport security. It does not make that port an HTTPS listener. An HTTPS connector must be configured and listening separately.

In multi-instance configurations, portOffset can shift the server port and nested connector ports. Two instances may therefore have different effective ports even when their XML values appear similar. Compare the effective configuration and startup logs for each instance.

Rank #2
Sale
Smart Watch for Men Women Compatible with iPhone Samsung Android Phone 1.69 inch Full Touch Screen IP68 Waterproof Bluetooh Fitness Tracker Heart Rate/Sleep Monitor (Black)
  • 【IP68 Waterproof Multifunctinal Smart Watch】Torjalph fitness activity tracker smart watch is IP68 waterproof technology ,you can wear it when swimming,handwashing,it's rain-proof which means that you perform multiple exercise modes outside without worrying about sweat or rain corroding your fitness smart watch,and this watch equipped with a 230 mAh large capacity battery magnetic charging ,and this sports activity tracker watch can be used 5-7 days If fully charged.
  • 【Larger 1.83'' Full Screen Watch & Multi-dial Selection】1.83 inch full HD color touch screen smart watch for men / women provides excellent 240*284 resolution image quality ,This Bluetooth smart watch offers a better touch experience and remarkable immersion and ,more than 200 watch faces for you to choose from App"Da Fit ", you can change the dial style according to your mood to wear keeping the world on your wrist
  • 【Accurate Activity Tracker Smart Watch 】sports watch activity tracker uses sweat and dust resistant breathable silicone strap, our Fitness Tracker Smart Watch for Android iOS Phones supports 12 sports modes,walking,running,bicycle,swimming,badminton,basketball,football,rope skipping. This bluetooth calls smart watch for men women is lightweight and stylish, bringing more convenient and relaxing sports experience while also providing more protection.
  • 【Your 24 Hour Personal Daily Health Monitor】Fitness watch for women men full touch screen IP67 waterproof bluetooth smartwatch for Android iOS Phones with heart rate blood pressure monitor multifunction Andriod smart watch with steps counter sleep monitor sports fitness watch, monitoring blood oxygen saturation allows you to understand your physical condition in real time to track fitness progress ,to know your health status in time.
  • 【More Functions Bluetooth Call Smart Watch】This fitness activity smart watch full screen for iPhone and Android phones includes a bunch of new features including:The bluetooth smart watch can hang up the phone, receive and display WhatsAPP /Text /Facebook /Twitter /Messenger reminder.Support sedentary reminder, alarm clock, stopwatch, timer,weather information,music control, remote camera control compatible with Android 5.0 and above or iOS 9.0 and above smartphones.

Change the active connector safely

  1. Stop or prepare to restart the correct instance. Record the service name, container, or startup command that launches it. This prevents a successful restart of one instance from being mistaken for a change to another.
  2. Back up the active file. Copy the instance’s conf/server.xml before editing. Preserve the original so a malformed XML change can be reversed quickly.
  3. Edit only the intended connector. Change the HTTP connector’s port value to a numeric, unused port. Do not change the outer Server port when you intend to change browser traffic. If you are moving HTTPS, edit the SSL connector instead and review the related redirectPort.
  4. Choose a bindable port. Apache Tomcat’s startup guidance says: “Change it to a port that isn’t in use, and is greater than 1024, as ports less than or equal to 1024 require superuser access to bind under UNIX.” On Unix-like systems, a port at or below 1024 normally requires the process to have the necessary elevated privilege. A higher unused port avoids that requirement for ordinary deployments.
  5. Validate the XML. Keep the connector inside the correct Service element, close every element, and retain required attributes such as protocol. A syntax error can prevent startup even when the port itself is free.
  6. Restart Tomcat. Saving the file is not enough. Tomcat does not reload server.xml as a live port change; stop and start the same service, container, or CATALINA_BASE instance.
  7. Read the startup log. Confirm that the connector initialized and look for bind errors, XML parsing errors, or a message identifying the effective port. If startup failed, fix that error before testing from a browser.
  8. Test the new URL. Replace the old port in the browser, API client, health check, reverse proxy, and firewall rule. A port change does not alter the application path.

Check whether another process owns the new port

Only one server application can listen on a particular port and IP address at a time. A second Tomcat instance, another Java service, a development server, or a system daemon may already own the value you selected. The operating system’s listener table is more reliable than guessing from configuration files.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Linux and other Unix-like systems

Use one of these diagnostic commands with the actual port number:

ss -ltnp | grep ':1977'
lsof -nP -iTCP:1977 -sTCP:LISTEN

The first command displays listening TCP sockets when ss is available. The second identifies the process and command line when lsof is installed. You may need elevated privileges to see another user’s process details. If a process owns the port, determine whether it is the intended Tomcat instance before stopping it.

Windows

PowerShell can query the listener directly:

Get-NetTCPConnection -LocalPort 1977 -State Listen

On systems without that cmdlet, use:

netstat -ano | findstr :1977

The final column from netstat is a process ID. Map it to a process with the normal Windows process tools, then verify the service identity. Do not terminate a process merely because it uses the desired port; it may be a production service.

Interpret a bind failure correctly

If the log reports Address already in use, changing the browser URL will not help because Tomcat never obtained the socket. Select another free connector port or stop the conflicting process according to your operating procedures. Also check whether an old Tomcat process remained after a failed restart and whether two service definitions launch the same instance.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
New Bee Guitar Cable 10ft Electric Instrument Bass AMP Cord
  • [Low Noise High Fidelity] New bee guitar cord with 22AWG oxygen-free-copper center conductors provides enhanced signal transfer, the PVC insulation material and the high-density stranded copper double shield provide noise rejection for quiet operation
  • [Ideal for Choice] New bee 1/4 straight and right angle metal connectors, ensures a secure connection in any instrument, pedal, or amp jack. L shape great fro on stage guitar stands
  • [Wide Compatible] Suitable for mixer, power amplifier, microphone, effector, decoder, equalizer, electoronic organ, electric guitar, electric bass and other electronic equipments. Widely used in the installation of smart home, karaoke speaker, professional stage audio, etc
  • [Easy Disassemble] Making incidental repairs quick and easy! Very nice, flexible cable
  • [Dont Hesite to Order] 24 hours customer services and professional technology team are standing by

Restart the same Tomcat instance you edited

A common cause of apparent non-response is restarting a different installation. A manual command may use one CATALINA_BASE, while a system service uses another. Containers can mount a host directory over the image’s configuration, and an IDE may launch an embedded copy.

Use the control mechanism that owns the running process:

  • For a system service, restart that service and inspect its status and journal or event log.
  • For a manual installation, stop it with the instance’s shutdown script or normal process-control method, then start it with the same environment variables and base directory.
  • For a container, recreate or restart the container after changing the mounted configuration, and verify that the host-to-container port publishing still maps the new value.
  • For an IDE-managed server, stop and start the server configuration shown by the IDE rather than launching an unrelated Tomcat from a shell.

The Context reference and startup guidance both require a restart for server.xml changes. If the old port remains open after your restart, inspect the process command line and listening sockets to discover which instance is actually running.

Use the new host and port when testing

After a successful restart, test locally on the machine where Tomcat runs:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
curl -i http://localhost:1977/

Use the server’s real hostname or IP address when testing from another machine. A browser bookmark, monitoring probe, API client, reverse proxy, or load-balancer target that still contains :8080 will continue to fail even though Tomcat is healthy on :1977.

Rank #4
BSIMB 15.6" Digital Family Calendar & Chore Chart, No Subscription Fees
  • Digital Family Calendar: BSIMB digital calendar wall touch screen puts an end to your chaotic life. Designed for busy families, the digital calendar keeps you organised and in step with your family. Assign different colours and tasks to each family member to make family scheduling easier and more intuitive.
  • Easy Setup and Auto-Sync: Plug in, connect to WLAN and auto-syn your electric calendar in minutes. Digital wall calendar compatible with Google calendar, iCloud calendar, Outlook calendar, Cozi calendar and Yahoo calendar. Add events directly on the device or through the ecalendar app. Electronic calendar stays current whether you're at work or traveling—no manual updates needed.
  • All-In-One Home Assistant: Smart calendar builds habits and encourage independence with personalised chores. Display daily meal plan to reduce the daily ‘What's for dinner?’ stress. To-do lists keep track of everything you want. Turning chores into valuable achievements with stars and rewards, making life easier and more enjoyable.
  • Manage Anytime Anywhere: BSIMB electronic calendar for family stay connected with the powerful ecalendar app. Access and manage your digital wall calendar anytime, anywhere with free features like stars & rewards, photo screensaver, chore charts, meals plans, to-do lists etc. Electronic planner paid features like Magic Import tailor advanced tools for users with special needs.
  • Stay in Touch with Loved Ones: Share photos or videos from your phone to electronic wall calendar with app, instantly update your life moment, and keep in touch with your family, especially those who are far away; you can also surprise your smart calendar digital wall by sending him a wish card; it's also great for keeping tech-illiterate elders in touch with the youngsters.

Check the protocol as well as the number. Sending HTTP to an HTTPS connector can produce a protocol error; sending HTTPS to an HTTP connector can produce a handshake failure. Use the URL scheme that matches the connector you configured.

When local access works but remote access fails

If localhost succeeds while a remote client cannot connect, Tomcat has probably completed its bind and the remaining problem is outside the connector’s numeric port value. Work outward from the server:

  1. Check the connector address. A connector bound only to loopback accepts local traffic but not connections arriving on the server’s network interface. Review any address attribute or equivalent bind setting.
  2. Check the host firewall. Permit the selected TCP port in the operating system firewall, using the correct network profile and source ranges.
  3. Check cloud or virtual-network policy. A security group, network ACL, or provider firewall may still allow 8080 while blocking the new value.
  4. Check container publishing. The connector’s container port and the host’s published port are separate. Update the publishing rule and then recreate or restart the container.
  5. Check proxies and load balancers. Update the upstream target, listener, health check, and any TLS termination rule. A proxy can continue sending traffic to the old port even when direct access works.
  6. Test from the client network. A successful local curl proves only local reachability. Test the hostname, DNS result, route, and TCP connection from the same network as the failing user.

Do not expose the shutdown port to the network as a workaround. It is an administrative control channel, not a web listener, and should remain restricted.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

When the port answers but the application is unavailable

A Tomcat landing page or an HTTP response proves that the socket and at least one web application answered. It does not prove that the requested application URL is correct.

Use the deployed context path

Tomcat commonly derives an application context from the WAR filename or an explicit context configuration. An application deployed as myapp.war is normally requested at /myapp/, not automatically at /. Request the path shown by your deployment configuration:

curl -i http://localhost:1977/myapp/

Changing a connector port does not rename a WAR, alter its context path, or move its static resources.

Verify deployment state

  • Confirm that the WAR or exploded directory is present in the active instance’s webapps location.
  • Read the application and host logs for deployment exceptions, missing dependencies, permission errors, or failed initialization.
  • Check whether an explicit Context configuration points to a different document base or path.
  • Make sure you are reading logs from the same CATALINA_BASE that owns the connector.

Tomcat’s Context configuration is separate from the connector. If you change context settings in server.xml, restart as well; those changes are not made live simply by saving the file.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Fix HTTPS and redirect-port mismatches

HTTP and HTTPS usually use separate connectors. Suppose HTTP listens on 1977 and HTTPS listens on 9443. A request that requires confidentiality may be redirected to the value in redirectPort on the HTTP connector. If that value still points to an old secure port, the redirect can lead to a refused connection or to the wrong service.

When changing the secure port:

  1. Locate the SSL/TLS connector and change its port to the chosen unused value.
  2. Review the non-SSL connector’s redirectPort and set it to the actual HTTPS listener when redirects are required.
  3. Confirm that certificates, proxy forwarding rules, health checks, and firewall permissions refer to the same secure port.
  4. Restart Tomcat and test both the direct HTTPS URL and an HTTP request that should redirect.

The SSL HOW-TO specifically calls out updating redirectPort when the secure port changes. A working HTTP connector does not demonstrate that the SSL connector is configured correctly.

Account for multiple Tomcat instances

Running more than one instance on a host requires unique listening combinations. Each instance needs its own HTTP connector port, HTTPS connector port, and shutdown port on the same IP address. If an instance uses portOffset, its effective values may be shifted from the numbers visible in the base configuration.

Compare the startup logs and complete server.xml files for all instances. Look for duplicate connector values, duplicate outer Server ports, and service definitions that accidentally start the same base directory twice. A successful first instance can occupy a port and cause only the second startup to fail.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Use logs to choose the next diagnostic branch

Log or test result Meaning Next step
XML parse error before connector initialization The edited configuration is not valid XML or contains an invalid attribute Restore the backup or correct the element structure, then restart.
Bind exception for the selected port Another process or instance owns that address and port Inspect listeners, free the port, or choose another value.
Connector initialized on the new port; local curl is refused You may be testing a different address, protocol, or process than the log describes Verify the URL scheme, hostname, effective instance, and listener table.
Local HTTP response with 404 for the root path The socket works; the requested context may not exist at / Request the deployed context path and inspect deployment logs.
Local success but remote timeout or refusal Traffic is blocked or not routed to the host Check bind address, firewall, security group, port publishing, proxy, and load balancer.
HTTP redirect points to an unavailable secure port redirectPort and the HTTPS connector do not match Align the values, verify the SSL listener, and restart.

A complete recovery checklist

  • Identify the process and active CATALINA_BASE.
  • Open that instance’s conf/server.xml, not a similarly named installation.
  • Confirm whether the desired endpoint is HTTP or HTTPS.
  • Change the matching connector’s port; leave the shutdown port alone unless you are deliberately reconfiguring administration.
  • Choose a free port, preferably above 1024 for an ordinary Unix deployment.
  • Check listeners with the operating system’s socket tools.
  • Validate XML and retain a rollback copy.
  • Restart the same service, container, or manual instance that owns the configuration.
  • Read startup logs for connector initialization and bind errors.
  • Test http://host:new-port/ or the corresponding HTTPS URL.
  • Use the application’s real context path, such as /myapp/.
  • If only remote access fails, update network controls and proxy or container mappings.
  • If HTTPS is involved, align the secure connector and redirectPort.
  • For multiple instances, compare all effective ports and any portOffset values.

Prevent the next port-change outage

Document each instance’s HTTP, HTTPS, and shutdown ports alongside its service name and base directory. Keep a small change record showing the old value, new value, restart command, firewall rule, proxy target, and health-check URL. Reserve ports deliberately so a development server or second instance does not claim them unexpectedly.

Automated health checks should be updated in the same change as the connector. Test from both the Tomcat host and a representative remote network, and verify the application context rather than only the root landing page. These practices separate a successful socket change from a complete, reachable application deployment.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
PC Slower Than It Used to Be?Free scan - under a minute
Outdated Drivers Are Slowing You DownFree scan - exact matches

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.