Health Check: Free Disk Space (Local Home)
Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server and Data Center platforms.
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
About the health check
This check warns you if the free disk space for your Jira home directory falls below the recommended threshold. In clustered Jira Data Center installations, this is called the local home directory.
DFS environments
If your site is running Windows and the shared home has been set up as a DFS (Distributed File System) link, the check may fail even if there is enough free disk space. This is caused by a JDK bug, which means the check looks at the size of the C: drive on the machine hosting the DFS link, rather than the size of the target of the DFS link.
In these cases, we recommend manually checking the available disk space.
What is the recommended threshold?
The recommended threshold is calculated as either a percentage of the overall disk partition where your local home directory lives, or an absolute size, whichever is smaller:
- 10 GB, or
- 10% of the overall disk partition
Default threshold values are static and can't be changed.
Example 1
If you have more than 100GB total partition disk space, we warn you if your free disk space falls below 10GB, because it’s lower than the minimum size threshold.
Based on the above example if we have a 200GB disk partition, this will be the result:
Free disk space | Result |
|---|---|
5 GB | The check will fail, and you’ll see a warning |
15 GB | The check will pass |
Example 2
If you have less than 100GB total partition disk space, we warn you if your free disk space falls below the 10% threshold, because it's lower than the minimum size threshold.
Based on the above example if we have a 40GB disk partition, this will be the result:
Free disk space | Result |
|---|---|
1 GB | The check will fail, and you’ll see a warning |
5 GB | The check will pass |
Understanding the results
| Icon | Result | What this means |
|---|---|---|
 Pass | Your free disk space is more than, or equal to, the recommended threshold. | You have enough free disk space for Jira to operate safely. |
| Pass | We can't verify the free disk space. | This usually happens because we can’t find the location of your local home directory, or if the application doesn't have access to the home directory. You can manually perform this check by reviewing your free disk space. |
 Warning | The free disk space is below the recommended threshold. | Your free disk space is running low. If the disk becomes full, Jira functionality will be affected. |
What happens if I ignore the warning?
Different types of Jira functionality can fail once the disk runs on out space – depending on how the disks have been configured. For example:
- Jira may fail to startup
- Items in the user interface may be missing
- Attachments may fail to upload
- Index-related processes may fail or run very slowly (for example, reindexing, commenting, transitioning)
Resolution
1. Review your current disk usage
It’s a good idea to check your current disk usage first, and free up some space if you can. Log files and backups can consume large amounts of space, so it’s worth looking for:
- Old log backups
- Old or excessively large log files
- Old automated XML backups.
Specific directories you may want to check:
- <Jira home directory>/log
- <Jira home directory>/export
2. Provision additional disk space
If you're not able to free up enough disk space, you’ll need to provision additional space to the disk partition that stores your local home directory.
If you have no space left, follow the steps outlined in Jira server functionality fails with No space left on device error.