The Atlassian Community Forums are currently in read-only mode. We will be relaunching on a new platform on September 22 (read more here). We apologize for the extended downtime. For concerns or questions, please email communitymanagers@atlassian.com. See you on the other side, on the new Atlassian Community Forums! :)

×

Forums

Articles
Create
cancel
Showing results for 
Search instead for 
Did you mean: 

runs-on not working for any runner

Michał
May 26, 2026

Why the following not working


runs-on
:
- self.hosted

I want to run on any self hosted so what is the problem that the runner cannot be found?

2 answers

Comments for this post are closed

Community moderators have prevented the ability to post new answers.

0 votes
Mark C
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
May 28, 2026

Hi @Michał

Thanks for reaching out to the community.

Could be related to indentation about the config, could you try the below config instead?

pipelines:
  default:
    - step:
        runs-on: self.hosted
        script:
          - some_script_here

Regards,
Mark C

0 votes
Anwesha Pan
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Champions.
May 28, 2026

Hi @Michał 👋🏻

Thanks for your question. 

It looks like your syntax isn't working because Bitbucket Pipelines does not use the generic self.hosted label. Instead, it uses a custom or system-assigned label matching system. If a runner is offline, unregistered, or the label is misspelled, the pipeline will fail to locate it.

You do try the following options:

  1. Use the correct runner label
    Replace - self.hosted with the exact label assigned to your runner during setup (e.g., - self.hosted-linux, - windows, or a custom tag)

  2. Check the label in Bitbucket
    • Go to your Repository or Workspace Settings.
    • Click on Settings -> Pipelines -> Runners
    • You must use one of these exact strings in your bitbucket-pipelines.yml file.

  3. Verify Runner Status
    Your pipeline will throw an error if the runner is in an Offline status. Ensure that the machine hosting the runner is powered on and that the runner application is actively running in the terminal or as a service
For more details on configuring your custom runner environments, you can visit the Bitbucket Configure Runner Guide.

I hope this helps & resolves your issue. 🙂

Thanks,
Anwesha

DEPLOYMENT TYPE
CLOUD
TAGS
AUG Leaders

Atlassian Community Events