Configuring the JIRA HOME over an UNC path
Platform Notice: Data Center - This article applies to Atlassian products on the Data Center platform.
Note that this knowledge base article was created for the Data Center version of the product. Data Center knowledge base articles for non-Data Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Scenario 1
Sometimes there is a need to set up the JIRA Home directory over a remote server. This KB addresses this configuration on a Windows Server environment. This same configuration does not apply to set up JIRA Home directory on a UNIX (or Linux) operational system.
This configuration may cause you performance problems (please check this page for any further information).
Scenario 2
If you are seeing the following exception in JIRA log when trying to configure shared home directory for JIRA Data Center, please proceed to resolution 2:
JIRA has no permission to either create or write to subdirectory 'data' of jira.home 'x:\path\to\sharedhome'.Resolution 1
- Open the
jira-application.propertiesfile on a text editor (such as notepad); Set the path for the home directory as the following example:
jira.home = \\\\<your-servername>\\<your-share>\\<jira-home>
You may also set the same parameter on the config.batscript. Hence, you must have access and write permissions on the target Windows share.
Resolution 2
- Open the cluster.properties file on a text editor.
Set the path for the home directory as the following example:
jira.shared.home = \\\\133\\jira Must have access and write permissions on the target Windows share.