How can I change the BitBoxApp gap limits?

In certain circumstances, it is necessary to manually increase the gap limits used by the BitBoxApp. Please choose your operating system, which gap limit you would like to increase, and run the appropriate command on the command line.


Make sure that the BitBoxApp is closed before running the command.

On Mac and Linux:

  • To change the receive address gap limit to e.g. 50:

open -a BitBox.app --args -gapLimitReceive 50

  • To change the change address gap limit to e.g. 50:

open -a BitBox.app --args -gapLimitChange 50

  • To change both, receive address gap limit and change address gap limit to e.g. 50:

open -a BitBox.app --args -gapLimitReceive 50 -gapLimitChange 50

On Windows:

  • To change the receive address gap limit to e.g. 50:

.\BitBox.exe -gapLimitReceive 50

  • To change the change address gap limit to e.g. 50:

.\BitBox.exe -gapLimitChange 50

  • To change both, receive address gap limit and change address gap limit to e.g. 50:

.\BitBox.exe -gapLimitReceive 50 -gapLimitChange 50