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

Is it possible to validate a pipeline locally?

Hi, I know about the bitbucket pipelines validator. I was wondering if there is a cli version to run locally, or some tips on how to validate as much as possible before pushing. It would greatly speed up the pipeline creation flow for me.

Couldn't find anything on atlassian repos or in the forums.


2 answers

0 votes


You can validate the bitbucket-pipelines.yml YAML format locally in our VS Code integration.

There is no local Pipelines agent that you can run your build locally with. You can open a feature request, for such a thing, here:

You can create a similar environment to Pipelines by running your scripts inside of Docker. And use that to debug your scripts locally. See here for more details:



Hello @Jesus Gollonet , validation against a schema similar to the one already mentioned is also possible with this local pipelines runner (shameless plug, written by me) which allows to validate the file on the command-line:

$ pipelines --validate

The schema (currently) is even with the latest Bitbucket Pipeline features, which the Vscode plugin does not validate yet. But I can also imagine that it can be lacking in the future whoever updates first.

There is no need to commit the file (or any related files) and the utility is designed with the (local) project in mind. It is also possible to do a dry-run to run further tests:

$ pipelines --trigger branch:master --dry-run

Or even execute it (which might need some environment variable setup, dot-env files are supported, incl. distribution templates - docker style).

It's not that everything works the same, I extend it as I need it. But I use it a lot for things like you ask for and also complete offline use for development.

Since some time there is also an accompanying homepage on Github, the read-me is going to outgrow:

Maybe it's useful to you.

Suggest an answer

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

What We Learned When We Researched Open Source Vulnerabilities in 7 Popular Coding Languages

...hey are a part of us, shaping how we interact with the world around us. The same holds true for programming languages when we think about how different kinds of vulnerabilities raise their heads in t...

1,049 views 0 3
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