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

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

settings.xml configuration on Pipelines

How do I specify the settings.xml file location for Maven on Bitbucket Pipelines?

8 answers

1 accepted

1 vote
Answer accepted

If you place a settings.xml file in the $HOME directory on your docker instance, it will be used to run your maven commands.

    - step:
          - cp <repo-path>/settings.xml $HOME/.m2/settings.xml
          - mvn clean install

This worked for me when I replaced 





any one know, what is the $HOME path here?

I'm late to this conversation but I wanted to point out that the accepted answer here seems to imply that the maven credentials are stored in a settings.xml file in the source code repository.

This is a security risk as you should never store credentials in source code repos. 

Instead, you should store your credentials in BitBucket Pipelines Secure Environment Variables and then substitute them into a settings.xml file during your build step.

We created a guide that demonstrates how to do this as part of getting pipelines setup with maven repositories in a professional, secure manner. 

For anyone coming along seeking an example please check it out:

Continuous Integration: A Complete Guide to Using BitBucket Pipelines With Maven Repositories

Good luck! 

Hello, I'm having the same problem. None of the above solutions helped me

Hi ,

any one know, what is the $HOME path here?

Oh, thanks @Bryan Phillips, this is awesome. Can you add this as an answer?

@Bryan Phillips,

That's how you update settings.xml in your local Maven repo, but we are talking about the remote settings.xml file that Bitbucket uses on the docker container when running mvn commands. At this point, I am guessing that the this files is a part of the maven:3.3.3 docker image listed in bitbucket-pipelines.yml

I just copied the settings.xml file from my repo to the home directory before building.

cp <project-path>/settings.xml $HOME/.m2/settings.xml

mvn clean install

Yes, we'd like to know how and specifically need to be able to configure the `<servers>` element with authentication info

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Bitbucket

New improvements to user management in Bitbucket Cloud 👥

Hey Community! We’re willing to wager that quite a few of you not only use Bitbucket, but administer it too. Our team is excited to share that we’ll be releasing improvements throughout this month of...

3,699 views 10 16
Read article

Community Events

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

Find an event

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

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you