Manage Your Database Size

The amount of storage your YouTrack Cloud database supports is determined by your YouTrack license. For each user account your license covers, 3 GB is allotted to your database.

For example, a free plan that supports 10 user accounts has a storage size of 30 GB. A license that covers 200 user accounts has a storage size of 600 GB.

note

YouTrack licenses that were registered before November 8, 2018, that have not been converted to the per-user pricing model have set storage limits. To upgrade to a license with larger storage limits, see Switch from an Old Commercial License to a Subscription with Per-user Pricing.

On average, YouTrack requires 1 GB of disk space to store approximately 5,000 issues. However, this is only a rough estimation. The exact amount of required space depends on the actual number and size of the files that are attached to issues in your installation. If, for example, you frequently attach large media files to each of your issues, your database will take up much more space per issue.

If your instance exceeds the amount of storage that is allocated on a per-user basis, a warning is displayed in the License Details section of the Global Settings page. To increase the amount of available disk space, you need to add users to your license. If you fail to add users to your license and continue to overuse the allocated storage space, access to the instance may be restricted.

YouTrack sends a warning to the administrator email address when an environment is close to reaching the storage limit. It is important that this email address can reach someone that can take action on matters such as approaching storage limits.

It is recommended to not maintain a large database with unnecessary data. As the size of your database grows, the time it takes to execute queries can increase. Complex queries may take longer to process, affecting the overall system responsiveness.

Large attachments are usually the reason for your storage to approach or exceed your database limits. Deleting attachments to issues, tickets, and articles should be your first attempt at reducing your storage size.

Use the search term sort by: {attachment size} desc to display items in your projects or knowledge base that contain large attachments. Decide what attachments are unnecessary and remove them.

• Attachments that are deleted directly are permanently removed immediately with no additional actions required.

• Issues containing attachments being deleted are moved to a recycle bin and still consume database space for around two weeks until permanently removed. Users with permission can permanently remove items sooner using the Permanently Delete Items feature.

The YouTrack database cleanup process and resource utilization monitor run asynchronously. This means that after an item is permanently deleted, the system may take up to several hours to sync and show freed space in the database.