Forums

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

could you please run server side garbage collection on our repository?

Lauren OMeara
November 29, 2025

Hi Bitbucket folks. 

I have seen several other requests like this. We had a large file in the repo history, followed the instructions you provided to remove it from history and run garbage collection on our end. The mirrored repo is about 250MB smaller. Can you please run garbage collection on your end so that the repo in bitbucket reflects this? 

Please let me know what additional info you need. 

1 answer

1 vote
Tansu Akdeniz
Community Champion
November 29, 2025

Hi @Lauren OMeara 

Welcome to the community!

I notified the Atlassian support team and they will reach out to you.

Lauren OMeara
December 3, 2025

Thank you for forwarding my request to the support team. I haven't heard anything from them yet. 

Lauren OMeara
December 11, 2025

@Tansu Akdeniz Checking in again. I haven't heard anything yet. What's the usual timeframe for something like this?

Ben
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
December 14, 2025

Hi @Lauren OMeara 

Apologies for the delay. Thank you for your patience. 

I've ran garbage collections against those large repositories, and it only reduced the size by 15mb. This can be caused by a few things, most notably the presence of pull requests, which can inflate the size of the repository (as data is stored to speed up the calculation of PR diff's) or an incorrect execution of cleanup commands.

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)

Suggest an answer

Log in or Sign up to answer
DEPLOYMENT TYPE
CLOUD
PERMISSIONS LEVEL
Product Admin Site Admin
TAGS
AUG Leaders

Atlassian Community Events