How to Separate The Home and Install Directories In JIRA
Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.
Note that this KB was created for the Data Center version of the product. Data Center KBs 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
JIRA requires that your <JIRA-home> directory is not the same or a sub-directory of your <JIRA-Installation> directory. Use the following process to separate the two folders.
Stop JIRA
Backup your current installation directory
Create a new directory meant to used for your
<JIRA-home>Move the following files/folders from your
<JIRA-Installation>into the new<JIRA-home>directorycaches
data
databases (might not exist)
export
import
log
logos
monitor
plugins
tmp
dbconfig.xml
jira-config.properties (might not exist)
Edit your
<JIRA-installation/atlassian-jira/WEB-INF/classes/jira-application.properties>file to point to the new location of the home directoryStart JIRA
When starting JIRA, you should be back to what your old instance looks like. If you are prompted to create a new instance shut JIRA down and make sure you've defined your <JIRA-home> correctly.
Was this helpful?