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

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

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.

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:



Suggest an answer

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

Admins, notify your Jira instance of system-wide changes with the new admin announcement banner

Hi All! We’re excited to share the launch of an announcement banner that lets Jira site administrators communicate directly to their users across their  Jira Cloud instance.  ...

549 views 15 18
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