Bfg-repo-cleaner: Installing BFG

[CrazyDeafBrony]

I am currently having issues with large files in my repository, and I have been told to install BFG, but I have no idea how to even start the install. Is there an easy way to do this and, once installed, how do I ensure it works with my repo?

[rtyley]

Hi @CrazyDeafBrony - the BFG requires Java 7 or above, and then a Java jar, which can installed manually. On some operating systems volunteers have packaged the BFG to make the process even easier, but without you telling me what system you're using, I can't advise you further.

Have you read the instructions?

https://rtyley.github.io/bfg-repo-cleaner/#usage

[CrazyDeafBrony]

Hi,

I'm using a Windows 7 Professional Edition, and I've downloaded the latest
version of Java. I had just tried again recently, but no success here.

On Tue, Sep 1, 2015 at 11:29 PM, Roberto Tyley [email protected]
wrote:

Hi @CrazyDeafBrony https://github.com/CrazyDeafBrony - the BFG requires
Java 7 or above, and then a Java jar, which can installed manually. On some
operating systems volunteers have packaged the BFG to make the process even
easier, but without you telling me what system you're using, I can't advise
you further.

Have you read the instructions?

https://rtyley.github.io/bfg-repo-cleaner/#usage

—
Reply to this email directly or view it on GitHub
https://github.com/rtyley/bfg-repo-cleaner/issues/106#issuecomment-136722659
.

[DanielGGordon]

Could you give us some more information? I am running Windows 7, and had no issues at all with BFG. Are you saying you are having trouble installing Java? If so, then that is not a BFG issues and this should be closed.

[CrazyDeafBrony]

Hi, sorry this issue was resolved a few weeks ago, I just had to change
over to git bash and enter a few lines to remove big files, but the bfg
works for me well now.

On Sat, Sep 26, 2015 at 2:25 AM, Daniel Gordon [email protected]
wrote:

Could you give us some more information? I am running Windows 7, and had
no issues at all with BFG. Are you saying you are having trouble installing
Java? If so, then that is not a BFG issues and this should be closed.

—
Reply to this email directly or view it on GitHub
https://github.com/rtyley/bfg-repo-cleaner/issues/106#issuecomment-143268368
.

[JasonFitz]

I have Java 8 (update 66) on a Windows 7 machine. When i double-click the bfg jar file I downloaded, nothing happens (bfg-1.12.8).

[rtyley]

Did you follow the usage instructions?

https://rtyley.github.io/bfg-repo-cleaner/#usage
On 26 Jan 2016 19:43, "JasonFitz" [email protected] wrote:

I have Java 8 (update 66) on a Windows 7 machine. When i double-click the
bfg jar file I downloaded, nothing happens (bfg-1.12.8).

—
Reply to this email directly or view it on GitHub
https://github.com/rtyley/bfg-repo-cleaner/issues/106#issuecomment-175195426
.

[JasonFitz]

ok I figured out I need to rename file and place jar file in the same directory as my local repo (correct)? Then to run"java -jar bfg.jar --strip-blobs-bigger-than 100M some-big-repo.git" I should add the path to the cloned directory?

[360disrupt]

JasonFitzs comments should be added to the readme.

[albertbuchard]

This post helps:
https://medium.com/@rhoprhh/removing-keys-passwords-and-other-sensitive-data-from-old-github-commits-on-osx-2fb903604a56#.xomadhrd5

[chasms]

The README should include an installation section. Was able to find in the above linked medium post that bfg can be installed via homebrew - brew install bfg - this is absent from readme and .io site. @rtyley we have all read the instructions and have had to look elsewhere for installation details. Otherwise, thanks for the helpful tool!

[LoganGray]

I absolutely agree with Chasms above. The README should include an installation section.
There should be a simple step by step installation for the complete newbie in every situation. There should be absolutely no assumption of any knowledge of java, or OS either.
I would suggest instructions for the following OS and situations. NOT just Mac. That is an assumption!
In my opinion, there should be installation for the following at least: Mac, Windows 7/10, & Linux (Ubuntu/debian, & CentOS) esp. for Vagrant users.

[adamreisnz]

Is there any particular reason this package can't be converted somehow so it can easily be installed with brew or another package manager? Having to install a Java runtime just to clean some files from a repo seems like an unnecessary evil.

[pierrettemugisha]

it would be also easier to install it globally. For instance, I just used it and I had to put it in the repository I want to clean, and that just isn't right. It is a necessary tool for most of us make mistakes in order to get something right. And sometimes you don't want an always reminder of what mess you have made as it marked you int all you do now.
I am asking myself if I should put the file name in my .gitignore or if I can simple delete it, and if I delete it won't I loose the change I just made?

[mesqueeb]

Related "is the homebrew version safe"?

312

[babno]

Something to help others. Many places, including the help, say simply write "bfg [option] [repo]" which doesn't work for me. What does work is doing java -jar bfg.jar [option] [repo]

[mesqueeb]

There's an interesting read by the author here on how to best install BFG:
https://github.com/rtyley/bfg-repo-cleaner/issues/312#issuecomment-471954245

I learned a lot from his post and came to my own conclusion that it's ok to download it via "homebrew". Please consider the security before you do.

If you do go for homebrew it's as simple as:

1. brew install bfg
2. bfg [option] [repo]

Much nicer than having to install JAVA etc.etc.! 😊

[lixiaodongdg]

brew install bfg

[dougloyo]

For Windows: choco install bfg-repo-cleaner
https://chocolatey.org/