Technical Anshu
Tutorials Blog
🛠️ Jira Startup Fix

Jira Will Not Start Complete Diagnosis Guide Service Port Java Database Memory and Logs

The server rebooted, something changed, and now Jira simply will not open. In almost every case one of six things is broken - and Jira almost always writes down which one. Work the ladder in order and you will find it.

✍️ Technical Anshu🪟 Windows Server⏱️ 12 minute read
🎥 Watch the full fix in the video — every step shown live on screen

A Jira that will not start feels like a disaster, but it is really a queue of small checks. Do not reinstall anything yet. Jira on Windows starts in stages - the Windows service launches a Java process, Java opens the configured port, connects to the database, and loads your data. A failure at any stage stops the whole thing, and each stage leaves evidence in a different place. This guide walks the stages in the exact order a working admin checks them: service first, then port, Java, database, memory, and finally the logs that confirm the real cause.

C:\Program Files\Atlassian\Jira\logs\catalina log - the last lines after a failed start (illustration)
INFO: Starting Servlet engine: [Apache Tomcat] SEVERE: Failed to initialize end point associated with ProtocolHandler ["http-nio-8080"] java.net.BindException: Address already in use: bind INFO: Pausing ProtocolHandler ["http-nio-8080"] SEVERE: Failed to start component [Connector[HTTP/1.1-8080]]
What a failed Jira start really looks like - the log names the stage that died. Example lines shown as an illustration.
1

Step 1 - Is the Jira Windows Service Even Running

On Windows, Jira normally runs as a service. If the service is stopped, set to Manual, or crashing the moment it starts, the browser will show nothing at all - no Jira page, no error page, just a connection failure. This is the single most common cause after a server restart, so check it before anything else.

  1. Press Windows + R, type services.msc and press Enter
  2. Find the service whose name starts with Atlassian Jira and check its Status and Startup Type
  3. If it is stopped, right-click it and choose Start, then watch it for a full minute - a service that starts and quietly stops again is telling you the failure is deeper
  4. Set Startup Type to Automatic if restarts keep leaving Jira down
  5. If Start fails with an error, note the error code and move to the logs in Step 6 - the service manager rarely knows the real reason
2

Step 2 - Is Something Else Sitting on Port 8080

Jira's web connector listens on port 8080 by default. If another program grabbed that port first - a second Tomcat, a test web server, another Atlassian tool - Jira's Java process starts and immediately dies with a BindException. This is the classic failure right after installing something new on the same server.

  1. Open Command Prompt as Administrator
  2. Run netstat -ano | findstr :8080 - the last column is the PID of whatever owns the port
  3. Run tasklist | findstr 4820 (use your PID) to see the program's name
  4. If the owner is not Jira's Java process, either stop that program or move Jira to a free port in server.xml inside the conf folder of the Jira install directory
  5. Start the Jira service again and re-check - only one process can own a port
3

Step 3 - Does Java Match What Jira Expects

Jira is a Java application, and it is strict about which Java it runs on. A Windows update, a JDK upgrade, or a well-meaning cleanup can change JAVA_HOME or leave Jira pointing at a Java version it does not support. The result: the service fails within seconds, sometimes with no Jira log written at all.

  1. Open setenv.bat in the bin folder of the Jira install directory and check the JAVA_HOME or JRE_HOME line
  2. Open a Command Prompt, go to that Java folder's bin folder and run java -version - confirm the version actually exists there
  3. Check Atlassian's Supported Platforms page for your exact Jira version - each Jira release supports only specific Java versions, and guessing here wastes hours
  4. If Java was upgraded past what your Jira supports, point Jira back to a supported JDK rather than upgrading Jira in a panic
  5. Restart the service after any change - Java settings are read only at startup
4

Step 4 - Can Jira Reach Its Database

Jira stores everything in its database and refuses to start without it. If the database server is stopped, still recovering after the same reboot, out of disk space, or the password in Jira's configuration changed, startup stops at this stage. Jira reads the connection details from dbconfig.xml in the Jira home directory.

  1. Check the database service itself first - is SQL Server, PostgreSQL, MySQL or Oracle actually running and finished starting
  2. Open dbconfig.xml from the Jira home directory and confirm the server name, port, database name and username match reality
  3. Test the same credentials with the database's own tool - if the database rejects them there, Jira never stood a chance
  4. Check free disk space on the database drive - a full drive makes databases refuse connections in confusing ways
  5. If the server crashed hard, also check for a stale .jira-home.lock file in the Jira home directory later - delete it only when you are certain no Jira process is running
5

Step 5 - Is the JVM Running Out of Memory

Jira's Java process needs a heap - a reserved block of memory - sized in its startup settings. Too little heap and a growing Jira dies with OutOfMemoryError. Too much heap requested on a small server and the Java virtual machine cannot even be created, so the service fails instantly.

  1. Open setenv.bat in the Jira bin folder and look at JVM_MINIMUM_MEMORY and JVM_MAXIMUM_MEMORY
  2. Compare the maximum with the server's actual free RAM - the heap must leave room for Windows and the database if they share the machine
  3. Raise the maximum modestly if the logs show heap errors; lower it if the logs say the virtual machine could not be created
  4. Restart the service - heap changes never apply live
  5. Remember the honest rule: more heap hides a memory problem for a while, it does not fix a leak or an undersized server
6

Step 6 - Read the Logs and Let Them Confirm the Cause

Every stage above leaves its evidence in two places: the Tomcat logs in the logs folder of the Jira install directory (start with the newest catalina log), and atlassian-jira.log in the log folder of the Jira home directory. The method is simple and it is the step everyone skips.

  1. Stop the Jira service so the log stops growing, then try one clean start
  2. Open the newest catalina log and go straight to the end
  3. Walk upwards and find the first SEVERE or ERROR block - later errors are usually just consequences
  4. Read the Caused by lines under it - the deepest cause is the real fault
  5. Match that cause to Steps 1 to 5 above and fix only that stage, then start Jira once more
🔴 Honest warning before you change anything: take a backup first - copy the Jira home directory and back up the database - even though Jira will not start. Every fix on this page is safe on a healthy system, but a failed startup is exactly the moment a careless reinstall or a deleted dbconfig.xml turns a one-hour repair into lost projects. And if this Jira still runs an old Server edition, remember Atlassian ended support for Jira Server in February 2024 - the fix still works, but plan the move to Data Center or Cloud in calm time, not during an outage.

🎥 See the Complete Fix in the Video

The full Jira startup repair, step by step, with the exact screens and log lines shown live.

▶️ Watch Full Video
❓ Common Questions (FAQ)

Why does Jira stop working right after a server restart

Because a restart tests every dependency at once. The Jira service may be set to Manual, the database may still be starting when Jira gives up, another program may grab port 8080 first, or a Java update may have changed JAVA_HOME while the server was up. Check the service, then the port, then the database start order - in that sequence - before changing anything inside Jira.

The Jira service starts and then stops after a few seconds. What does that mean

It means the service launcher works but the Java process is dying during startup. The cause is almost always one of the stages in this guide: a port conflict, a Java version mismatch, a database it cannot reach, or a heap it cannot allocate. Do not keep restarting it - open the newest catalina log in the Jira logs folder and read the first SEVERE error from the end of the file.

Should I just reinstall Jira when it will not start

Almost never as a first step. Your projects, users and settings live in the database and the Jira home directory, not in the program files, so a startup failure is rarely the program files' fault. Reinstalling over a sick system can overwrite configuration and make diagnosis harder. Back up the home directory and database, read the logs, and fix the one stage that is actually failing.

This guide is based on the Technical Anshu video on fixing a Jira that will not start • Stuck on a step? Ask in the video comments — you will get a reply 🙏