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

Next challenges

Recent achievements

  • Global
  • Personal


  • Give kudos
  • Received
  • Given


  • Global

Trophy case

Kudos (beta program)

Kudos logo

You've been invited into the Kudos (beta program) private group. Chat with others in the program, or give feedback to Atlassian.

View group

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! 

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

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

@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

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

Hi ,

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

0 votes

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

Suggest an answer

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

Powering DevOps with Bitbucket Server & Data Center

Hi everyone, The Cloud team recently announced 12 new DevOps features that help developers ship better code, faster   ! While we’re all excited about the new improvements to Bitbucket ...

2,564 views 1 9
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