---
title: "addRunner"
canonical: "https://support.appfire.com/space/BCCLI/65767965/addRunner"
format: markdown
---
> Macro (aura-html)

See also: [Actions](https://appfire.atlassian.net/wiki/spaces/BCCLI/pages/65766635)

> Macro (details)
> 
> | **Description** | Add a pipeline runner to a workspace or repository. Exactly one platform label (linux, linux.shell, windows, macos) can be specified. Defaults to linux if none is provided. Also, self.hosted is added if not provided as required by Bitbucket. |
> | --- | --- |
> | **Required Parameters** | ([workspace](https://appfire.atlassian.net/wiki/spaces/BCCLI/pages/65765634) or [repository](https://appfire.atlassian.net/wiki/spaces/BCCLI/pages/65766277)), [name](https://appfire.atlassian.net/wiki/spaces/BCCLI/pages/65766239) |
> | **Optional Parameters** | [label](https://appfire.atlassian.net/wiki/spaces/BCCLI/pages/65767696) |
> | **Type** | [Create](https://appfire.atlassian.net/wiki/spaces/BCCLI/pages/65768932/Action+Types#ActionTypes-Create) |
> | **Category** | [Pipelines](https://appfire.atlassian.net/wiki/spaces/BCCLI/pages/65766329/Action+Categories#ActionCategories-Pipelines) |
> | **Output Formats** |  |
> | **Replacement Variables** | runner, runnerUuid, runnerType, runnerLabels, runnerOauthClientId, runnerOauthClientSecret, repository, repositoryFullKey, repositoryName, repositoryUuid, workspace, workspaceName, workspaceUuid |
> | **Since Version** | 10.4 |
> | **Examples** |  |

## Related How To's

> Macro (cql-query)