How to Upgrade Bitbucket Linux Shell Runners to Version 3.0.0 (non-Docker)

[Omar Dahroug]

Hi Bitbucket Community, I'm looking for guidance on upgrading self-hosted Pipelines runners that are set up as services on Linux shell (not using Docker).

The recent announcement about Pipelines Runner 3.0.0 mentions critical improvements but doesn't provide any instructions for upgrading non-Docker runners. The documentation only covers upgrading runners using Docker, leaving me uncertain about how to upgrade shell-based runners without starting from scratch.

From what I can tell, the only option might be to create new runners and delete the old ones, but I’d prefer a smoother upgrade path if possible.

Does anyone know if there’s a way to upgrade these runners without deleting and recreating them? Any advice or experiences with this would be greatly appreciated.

Thanks in advance!

Omar

[Tiago Jesus]

Hi guys,

I run my shell runners like a service.

I made these steps and everything works fine.

Script to do it:

* Stop shell runner (service)

* Delete the folder with the last version

* Run command: curl https://product-downloads.atlassian.com/software/bitbucket/pipelines/atlassian-bitbucket-pipelines-runner-3.6.0.tar.gz --output atlassian-bitbucket-pipelines-runner.tar.gz

* mkdir atlassian-bitbucket-pipelines-runner && tar -xzvf atlassian-bitbucket-pipelines-runner.tar.gz -C atlassian-bitbucket-pipelines-runner

* Start the service again

I hope I could help.

[Theodora Boudale]

Hi Omar,

The steps that Tiago provided here are correct. You don't need to delete the existing runners and create new ones. You can simply remove the folder with the older version of the runner, download the newer version and extract it at the same location.

I just wanted to add that we have released a new version of the runner, so instead of 3.6.0 you can download version 3.7.0 with

curl https://product-downloads.atlassian.com/software/bitbucket/pipelines/atlassian-bitbucket-pipelines-runner-3.7.0.tar.gz --output atlassian-bitbucket-pipelines-runner.tar.gz

Kind regards,
Theodora

[Omar Dahroug]

@Theodora Boudale any hints?