Is elasticsearch required for BB DC 4.6+?

We want update from BB DC to 4.0.4 to BB DC 4.8.6. We found inside of the documentation that BB DC 4.6+ comes with a new feature "elasticsearch".

Is it required to install elasticsearch or is it an optional feature which can be activated later?

2 answers

2 votes

Hi Thomas,

Elasticsearch is required in the sense that any search in Bitbucket Server (for repositories or code in those repositories) will not work unless Elasticsearch is installed and configured. If it's not, an error will be displayed to users when they try to search for repositories or code.

Best regards,


Premier Support Engineer

Thanks for this quick answer. But the installation chapter Is not very useful.

I do all the steps but the permission looks wrong. Which user/group must be assigned to the *elasticsearch* installation directory and its installed files?


where must the folder /config/buckler created? I do it like this

/usr/share/elasticsearch/config/buckler as descibed inside of the document.

The logging output brings [2016-11-09 14:06:49,495][WARN ][com.atlassian.elasticsearch.buckler.config.BucklerConfig] Buckler config file missing, tried path: /etc/elasticsearch/buckler/buckler.yml

How can I tested that elasticsearch works well?

Hi Thomas,

For Bitbucket Data Center we don't bundle Elasticsearch with Bitbucket Server itself, and as such we're unfortunately not in a position to be able to provide instructions or advice on how to install and configure it. You can refer to the Elasticsearch documentation for details on how to install, set up and configure the product.




Premier Support Engineer


Hi Christan,

I understand your arguments, but elasticsearch provides only documenation for the newest version 5.0. We must install Version 2.3.4.

The Bitbucket interface definition inside of

#Connect your Elasticsearch instance to Bitbucket Server user must named here ? it PW of the application or the user?

is this all on the BB DC side?

Hi Thomas,

Elastic still provides documentation for version 2.3 at

From an architectural perspective Bitbucket Server pushes the data to Elasticsearch, so all you need to do is tell Bitbucket Server where the Elasticsearch server is located and what the credentials are that it should use to access it, and that's what you do in the file. The credentials to use are the ones you specify/create in the process of setting up Elasticsearch.




Premier Support Engineer


Suggest an answer

Log in or Sign up to answer
Atlassian Community Anniversary

Happy Anniversary, Atlassian Community!

This community is celebrating its one-year anniversary and Atlassian co-founder Mike Cannon-Brookes has all the feels.

Read more
Community showcase
Piotr Plewa
Published Dec 27, 2017 in Bitbucket

Recipe: Deploying AWS Lambda functions with Bitbucket Pipelines

Bitbucket Pipelines helps me manage and automate a number of serverless deployments to AWS Lambda and this is how I do it. I'm building Node.js Lambda functions using node-lambda&nbsp...

1,768 views 1 5
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you