Technical Anshu
Tutorials Blog
📜 Log Reading Guide

How to Read Jira Startup Logs and Find the One Error That Stopped It

A failed Jira writes hundreds of log lines. Only a handful matter, and they are never the ones at the top. Here is the reading method admins actually use.

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

Every Jira startup failure on this site - service, port, Java, database, memory - ends at the same place: the logs. The problem is not a lack of information; it is too much of it, in the wrong order. A dying Jira logs the real error first, then dozens of follow-on failures as each subsystem collapses in turn. Beginners read from the top and drown; the last error they read is usually a symptom. This page gives you the two files that matter, and the end-first method that finds the one error that actually stopped Jira.

atlassian-jira.log - reading the failure from the end upwards (illustration)
... (hundreds of INFO lines from the failed start) ERROR [c.a.jira.startup] JiraStartupLogger - Database: Jira is unable to connect to the database Caused by: java.sql.SQLException: Login failed for user 'jirauser' INFO: Server startup in 4210 ms (an earlier, healthy start)
The deepest Caused by line is the truth; everything logged after it is consequences. Example lines shown as an illustration.
1

The Two Log Files That Matter

Jira writes to several places, but startup diagnosis needs only two. Learn their homes once and you will never hunt again. Both are plain text - open them in Notepad or any editor, and use the file's modified time to be sure you are reading the attempt you care about.

  1. The catalina logs live in the logs folder of the Jira install directory, named with dates, like catalina.2026-10-25.log - they cover the Tomcat container: service start, port binding, Java-level failures
  2. The atlassian-jira.log lives in the log folder inside the Jira home directory - it covers the application itself: database checks, plugin loading, startup checks
  3. Rule of thumb: if the failure happens in the first seconds, start with catalina; if Jira gets further and shows a startup error page in the browser, start with atlassian-jira.log
  4. Also remember the Windows Event Viewer - the service wrapper reports there when Java itself cannot start
2

The End-First Method

This is the whole technique, and it works because of how failures cascade. When one stage dies, everything that depended on it logs errors too - so the file fills with noise after the real error. Reading backwards puts the cause before the consequences.

  1. Stop the Jira service, note the time, and make one clean start attempt so the log holds one tidy failure
  2. Open the relevant log and jump straight to the bottom
  3. Move upwards and stop at the first SEVERE or ERROR block you meet - that is the earliest fatal error of this attempt
  4. Under it, find the Caused by lines and read the deepest one - that sentence, in plain language, is your fault: a login failed, a port is bound, a class version is wrong
  5. Ignore the shutdown and 'failed to start component' lines below the cause; they are the sound of the collapse, not its reason
3

Translate the Common Signatures

A few phrases cover most dead Jiras. Recognising them turns a wall of text into a diagnosis in one glance - and each maps to one fix, not five guesses.

  1. BindException: Address already in use - the port is taken; find the owner with netstat -ano | findstr :8080
  2. Login failed for user or Access denied - database credentials in dbconfig.xml do not match the database
  3. Could not create the Java Virtual Machine - the heap requested cannot be reserved; check setenv.bat values against free RAM
  4. OutOfMemoryError: Java heap space - the heap is too small for the workload, or something is leaking
  5. UnsupportedClassVersionError - the Java running Jira is older than the code expects; a JAVA_HOME and version problem
  6. A wall of plugin errors with a healthy database check usually means one bad or incompatible plugin - check what changed last
4

Keep the Evidence Clean While You Work

Logs are evidence, and repairs go better when evidence is not trampled. Restarting Jira ten times while guessing buries the original failure under ten new ones. Work like an investigator: one change, one start, one fresh read of the end of the log. If you must hand the problem to Atlassian support or a senior admin, that discipline - plus a zipped copy of both logs with the failure time noted - is exactly what they will ask for first.

  1. Note the clock time of each start attempt you make
  2. Change one thing per attempt, and write down what it was
  3. Copy both log files aside before any reinstall or upgrade attempt - they are the only record of the original fault
🔴 The one-line summary of this page: the last error is the loudest, the first error is the truth. If you take nothing else from Jira troubleshooting, take that - plus the habit of checking Event Viewer when no Jira log exists at all, because a Java that never started leaves its complaint with Windows instead.

🎥 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)

Where are the Jira log files on a Windows server

In two places. The catalina logs are in the logs folder inside the Jira install directory. The atlassian-jira.log is in the log folder inside the Jira home directory - on a standard Windows install, under C:\Program Files\Atlassian\Application Data\Jira. Always check the file's modified time to make sure you are reading the latest start attempt.

The logs are huge. How do I find anything in them

Use your editor's search with intent: jump to the end first, then search backwards for SEVERE or ERROR, and under the first fatal block read the deepest Caused by line. Searching for one phrase at a time - BindException, Login failed, OutOfMemoryError - also works well. Never read a startup log from the top; the top is yesterday's healthy start.

Jira wrote no new log lines at all for this failure. What does that mean

It usually means the failure happened before Jira could write - the Java virtual machine never started, or the service could not launch it. Check the Windows Event Viewer (Application and System logs) at the failure time, and verify JAVA_HOME and the Java version next. Silence in Jira's own logs is itself a strong clue pointing at Java or the service layer.

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 🙏