Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

Earn badges and make progress

You're on your way to the next level! Join the Kudos program to earn points and save your progress.

Deleted user Avatar
Deleted user

Level 1: Seed

25 / 150 points

Next: Root


1 badge earned


Participate in fun challenges

Challenges come and go, but your rewards stay with you. Do more to earn more!


Gift kudos to your peers

What goes around comes around! Share the love by gifting kudos to your peers.


Rise up in the ranks

Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!


Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

Detect and block a binary file

Is it possible to write a script in Adaptavist ScriptRunner which detects any binary file and denies commit which includes the file?

3 answers

1 accepted

2 votes
Answer accepted

Hi Piotr,

You can do this with ScriptRunner for Bitbucket Server. You need to use the pre-receive hook "protect git references" . You can enable this by going to Admin -> Pre-receive hooks -> Protect git references. The documentation for that is here.

You'll need to use a condition like the following on that hook to exclude the binary file extensions: 


The example above shows you how to do it for jar and exe files.

You can also use the "restrict file size" hook here to block files based on file size, which you may find useful to combine with the rule above.

Alternatively you can use the following as a custom pre-receive hook, but it may not catch every case. You should try it and see if it works for you:

import com.atlassian.bitbucket.commit.CommitService
import com.atlassian.bitbucket.content.AbstractDiffContentCallback
import com.atlassian.bitbucket.content.DiffRequest
import com.atlassian.bitbucket.content.Path
import com.atlassian.bitbucket.hook.HookResponse
import com.atlassian.bitbucket.repository.RefChange
import com.atlassian.bitbucket.repository.RefChangeType
import com.atlassian.bitbucket.repository.Repository
import com.atlassian.sal.api.component.ComponentLocator
import com.onresolve.scriptrunner.canned.bitbucket.util.BitbucketCannedScriptUtils

import javax.annotation.Nullable

def commitService = ComponentLocator.getComponent(CommitService)

def repository = repository as Repository
def refChanges = refChanges as Collection<RefChange>
def hookResponse = hookResponse as HookResponse

def msg = new StringBuilder()

refChanges.each { refChange ->
if (refChange.type != RefChangeType.DELETE) {

def commits = refChange.getCommits(repository)
if (!commits) {
// empty branch
def diffRequestBuilder = new DiffRequest.Builder(repository, refChange.toHash)

commits.first().parents.each {

commitService.streamDiff(, new AbstractDiffContentCallback() {
void onBinary(@Nullable Path src, @Nullable Path dst) throws IOException {
msg << "Binary file $dst not allowed - on branch: ${}"
super.onBinary(src, dst)

if (msg) {
hookResponse.out().write BitbucketCannedScriptUtils.wrapHookResponse(msg)
return false

return true

Hope this helps.


Hi Adam,

Thank you for your answer.

I guess relying on file extensions is the only way here - it is not possible to read a file somehow using ScriptRunner for BitBucket Server and detect any binary file, right?




Hi Piotr, 

You can do this but you need to perform a diff. I've updated my answer above. There are some cases which it may miss, but this is what Atlassian uses internally in Bitbucket to detect binary files.



Thank you !

Hi Adam,

Thank you for your answer.

I guess relying on file extensions is the only way here - it is not possible to read a file somehow using ScriptRunner for BitBucket Server and detect any binary file, right?




Recently we encountered one problem that commit size are too large , is it possible to block large commit size ? How could we monitor that if commit size over 1GB that will force user to push to server side?

0 votes

Hi Piotr,

ScriptRunner for Bitbucket provides a Pre-receive hook to restrict files by file size. Refer to

You can write a custom script if you would like to check for file types.



Suggest an answer

Log in or Sign up to answer

Atlassian Community Events