Forums

Articles
Create
cancel
Showing results for 
Search instead for 
Did you mean: 

Request to Run Garbage Collection on Bitbucket Repository

Nilesh Kuhikar
March 16, 2026

Hello Bitbucket Support Team,

I would like to request a manual garbage collection (GC) run on our Bitbucket repository to remove unreachable and dangling Git objects and reclaim repository storage.

Repository details:

Repository: [REDACTED]

Thank you.

 

2 answers

2 accepted

0 votes
Answer accepted
Ben
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
March 18, 2026

Hi @Nilesh Kuhikar 

I have attempted to reduce the size of your repository by executing a garbage collection, but it has not reduced the size. 

You have a couple of options to resolve this:

Option 1 - Delete & recreate the repositories
This is the fastest way to solve the problem, but loses metadata such as PRs, Pipelines, Permissions, etc.

  1. Perform a clone of those repositories for backup purposes

  2. Delete those repositories from your workspace to free up space and allow you to push. NOTE: This will permanently remove metadata such as PR's/pipelines/user permissions etc.

  3. Identify the largest files in your repositories by executing the following command:
    git rev-list --objects --all \
    | git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' \| awk '/^blob/ {print substr($0,6)}' \
    | sort -r --numeric-sort --key=2 \
    | numfmt --field=2 --to=iec-i --suffix=B --padding=7 --round=nearest

  4. Perform cleanup operations locally to reduce the size

  5. Once complete, push those repositories back to your workspace by creating a blank repository with the same name of the deleted repository, then mirror pushing the contents of the cleaned repository:

 

HTTPS
git push --mirror https://<username>@bitbucket.org/<WorkspaceID>/<RepoName>.git
SSH
git push --mirror git@bitbucket.org:<WorkspaceID>/<RepoName>.git

NOTE: This will remove metadata such as PR's/pipelines/permissions etc but will keep your commit history and binary files intact.

Option 2 - Temporarily upgrade

  1. Upgrade to a paid plan and utilise our 30-day trial period to restore functionality and provide more time to reduce your repository directly without deletion. You can choose to continue or cease your trial before the end of the 30-day period.

  2. If you encounter any issues during this period - you may raise a ticket directly with our support team using your workspace URL: Atlassian Support  

Please let me know how this goes.

Cheers!

- Ben (Bitbucket Cloud Support)

0 votes
Answer accepted
Salih Tuç
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Champions.
March 16, 2026

Hey @Nilesh Kuhikar ,

For contacting Bitbucket Support Team you can open a ticket from here.

For further information on maintaining Git repo in your instance, you can check this document. However, as far as I know, you need to open a ticket for Cloud instance.

Nilesh Kuhikar
March 17, 2026

Thank you @Salih Tuç 

However, when I try to open a ticket, it redirects me to the “Explore Communities” page.

I have cleaned the repository using git-filter-repo, and I kindly request you to run GC (garbage collection) on the Bitbucket server for my repository, as it is currently close to the 1 GB limit.

Please let me know once the process has been completed.

Thank you.



Salih Tuç
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Champions.
March 17, 2026

Hi @Nilesh Kuhikar ,

On your Bitbucket page, can you click to the Help -> Support.

After that, you will see "Contact Support" button at the bottom of the page.


Suggest an answer

Log in or Sign up to answer
DEPLOYMENT TYPE
CLOUD
TAGS
AUG Leaders

Atlassian Community Events