# Bitbucket Pipelines Runner

Bitbucket Pipelines Runner is a self-hosted development app. Self-hosted Bitbucket Pipelines runner for Unraid that executes pipeline step containers locally via the Docker socket with an outbound-only network connection. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/2660/bitbucket-pipelines-runner

## Description

Self-hosted Bitbucket Pipelines runner for Unraid that executes pipeline step containers locally via the Docker socket with an outbound-only network connection.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

65/100 (Good), based on 4 of 5 factors.
- Maintained: 88 (last commit 26 days ago)
- Popular: 40 (94 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 78 (no serious findings, CI, tests, OpenSSF Scorecard 4.4/10)

## Links

- Unraid: https://ca.unraid.net/apps/bitbucket-pipelines-runner-1ewnd79040l2i9?q=bitbucket-pipelines-runner
- Documentation: https://confluence.atlassian.com/display/ALLDOC/Atlassian+Documentation
- GitHub: https://github.com/mathieu-lemay/pipeline-runner

## Common questions

### How do I install the runner and start a pipeline run?

Install it with pipx install bitbucket-pipeline-runner. Then change into the repository directory and run pipeline-runner run to execute a pipeline.

### Where are pipeline artifacts, logs, and caches stored?

Artifacts and execution logs are stored in the user data directory, such as ~/.local/share/pipeline-runner on Linux or ~/Library/Application Support/pipeline-runner on macOS. Caches are stored in the user cache directory, while Docker cache is stored in a Docker volume.

### How can a pipeline step clone from a private Git repository over SSH?

Run the pipeline with the --ssh flag to expose your SSH agent to the step container. If the agent has multiple keys, the key required by the target Git host should be first.

### How do I force an amd64 pipeline container on Apple Silicon?

Set PIPELINE_RUNNER_DOCKER_PLATFORM to the target platform to affect only the pipeline container. To force all containers, set DOCKER_DEFAULT_PLATFORM, though the feature is still experimental.

### Does the Docker-based runner need inbound ports or a reverse proxy?

The Docker runner executes pipeline steps as Docker containers on the host using the Docker socket. The setup guidance says to ensure the runner has outbound-only network access.

### What security concern is associated with Docker-socket-based self-hosted runners?

Docker-socket-mounting runners can be insecure in environments with strict compliance requirements.

---
Source: Our Local Host (https://ourlocalhost.com/app/2660/bitbucket-pipelines-runner), the self-hosted and open-source app directory.
