If you have a server hosting Jira and Confluence, what timezone do you set it to? UTC, or the timezone your users are in?

There is a serverfault discussion about this, and on the face of it, the question is why wouldn't  you use UTC? Timezones are messy, ugly, human things. Why complicate your nice clean server with them?

In this post I'll outline why I think you should set your server to the timezone of the bulk of your users, rather than nice clean UTC, and specifically why, if you find yourself setting the -Duser.timezone=...  parameter, you're probably making life harder for yourself than necessary.

Keeping the same timezone within a server

First, I think we can all agree, log files on the same server should all use the same time zone.

There are at least 3 log-generating things you'll be concerned with:

• The app server (Jira, Confluence), and their log files (atlassian-jira.log, atlassian-confluence.log)
• The web server (Apache, nginx) and their log files (access.log)
• The operating system and its logs (/var/log/*) and persistent performance stats (e.g. /var/log/atop/*)

For your debugging sanity, it is essential that all these log files have the same timezone.

The web server and OS logs are all in the OS timezone, obviously. How about app server logs, atlassian-jira.log and atlassian-confluence.log?

App server log timestamps will also be in the OS timezone, unless you've told Java otherwise by explicitly setting -Duser.timezone . If you've set -Duser.timezone , you can no longer correlate datestamps between atlassian-jira.log, access.log and the rest of the system.

So don't do that. Leave Java in the same timezone as your OS.

Why not UTC?

There are two arguments against setting your server timezone to UTC.

The argument from ease-of-debugging

Users report problems relative to their timezone. Screenshots might be saved with timestamped filenames. "Things got really slow around 4pm" they'll say, and your job is to find what was happening on the server at 4pm.

I work on Linux, and my tooling hasn't evolved much since the 1970s. I don't know an easy way to convert log timestamps from UTC to that of an arbitrary user, on the fly. If the log's timezone is that of the user, life just is just easier.

The argument from Confluence developer laziness

"But", our administrator says, "I want UTC on the server for <insert sane, excellent reasons>, and I use <insert names of tool that let me view logs in any timezone, which I shall share with you in the comments>. Why can't the OS and Java be set to UTC, and the apps be told only to display dates in a specific format?"

The answer is that this would be possible, except that Confluence developers failed to implement a default user timezone setting ( ).

To review, the timezone users see in Jira and Confluence comes from one of various levels:

1) User preference	Users can explicitly set their timezone in their profile: Jira Confluence
2) Default user preference	If your user preference isn't set, the default user preference will be in effect. Jira Jira conveniently lets you edit the default user timezone in General Configuration: Confluence Confluence does not let you edit the default timezone ( ). Instead you have to resort to editing XML files inside jars.
3) Java user.timezone	The default user timezone preference inherits its value from the Java user.timezone Java property.  You can set this user.timezone Java flag in bin/setenv.sh, e.g. to -Duser.timezone=America/Los_Angeles .
4) OS timezone	Finally, Java sets its user.timezone property default to the operating system's timezone: $ cat /etc/timezone Australia/Sydney

So in Jira, everything is great. You can have atlassian-jira.log  use a timezone that's good for debugging (UTC if that's your preference), while the default timezone used to render dates can be something good for the majority of users.

In Confluence, sadly there is only one default timezone (Java's user.timezone ). It will have to be set to the timezone that makes sense for most users. This means atlassian-confluence.log will also use that timezone, and for consistency, so should the rest of the OS.

Conclusion

The conclusions are:

• Don't ever use -Duser.timezone  as it leads to inconsistent timezones across log files.
• Vote for (bitter laughter).
• If you running Confluence, your OS timezone should be set to what you want your default user timezone for users to be. Don't set -Duser.timezone .
• If you running only Jira, I still suggest setting your OS timezone to what you want the default user timezone to be, just to make debugging simpler. However you have the option to use UTC as your OS and Java timezone, as long as you set Jira's default user timezone explicitly.