Azure Pipelines Agent

Self-hosted Azure Pipelines and Team Foundation Server build and release agent, delivered as an Ubuntu 24.04 Docker image with preinstalled software for…

  • Development
  • Productivity
Self-hosted Azure Pipelines and Team Foundation Server build and release agent, delivered as an Ubuntu 24.04 Docker image with preinstalled software for running your build and release jobs on your own hardware.

Platform availability

Available on 2 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

75/100 Good

Maintained
100last commit 9 days ago
Popular
661,929 GitHub stars
Easy to install
452 install platforms, install notes, Docker image
Light to run
No data
Security check
66no serious findings, 10 minor, CI, tests, OpenSSF Scorecard 6.1/10

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 5 days ago

GitHub stars
1,929
Open issues
241
Last commit
2026-11-12
Latest release
v5.281.1
License
MIT
Activity
rising

Checked 9 days ago - source: GitHub (microsoft/azure-pipelines-agent)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is not supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Check the installed agent version before changing it Use your package manager (the tool that lists installed software) to check whether the agent is already present, for example yum list WALinuxAgent, apt list WALinuxAgent, or zypper info python-azure-agent. This helps you avoid overriding the version your system already provides. source
  • A missing-file background service error is usually harmless If the background service named waagent-network-setup.service fails because a file is missing, reboot the machine or restart that service. This error is usually not a real problem and does not need extra fixing. source
  • Add a proxy only if your network requires it If the machine cannot reach the internet directly, create a small systemd drop-in file (a simple settings file that controls how a service starts) for walinuxagent.service that sets the http_proxy and https_proxy settings (the web and secure web proxy addresses). This lets the agent use your proxy to reach Azure services. source

Fetched 54 days ago - each note links to its source

Alternatives (12)

  • Amazon Elastic Compute Cloud - Amazon Elastic Compute Cloud (Amazon EC2) is a web service that provides resizable compute capacity in the cloud.
  • Amazon Web Services - A pay-as-you-go cloud computing platform with services in networking, compute, storage, and IoT, accessible via global server farms.
  • DigitalOcean - Cloud computing platform with Droplets for virtual servers, managed Kubernetes, spaces for storage, and managed databases aiming at develop…
  • Google App Engine
  • Heroku - Heroku is a platform as a service (PaaS) that enables developers to build, run, and operate applications entirely in the cloud.
  • Hetzner
  • Korifi - Korifi is an open-source Platform-as-a-Service that implements the Cloud Foundry V3 API on Kubernetes, letting homelab users and teams self…
  • Linode - Delivers Linux-based cloud infrastructure with scalable VM, GPU, and storage options, predictable pricing, API access, global locations, an…
  • OpenShift - Red Hat OpenShift is a trusted, comprehensive, and consistent platform to develop, modernize, and deploy applications at scale, including t…
  • OpenStack - OpenStack OpenStack is a global collaboration of developers and cloud computing technologists producing the ubiquitous open source cloud co…
  • Vercel - Deploy to the most powerful serverless platform in the world with just one command.
  • Vultr - Deploy compute, storage, and bare metal servers in 16 locations with instant provisioning, SSD storage, flexible plans, API access, and one…

Checked 40 days ago - source: AlternativeTo

Common questions

How can I tell from inside a pipeline whether it is running on a Microsoft-hosted or self-hosted agent?

Check the Agent.Name variable in the pipeline. It identifies the agent that is running the job.

Why does my self-hosted Azure Pipelines agent not update automatically?

When it starts, the agent checks for jobs but does not check for a newer version unless explicitly told to. If it stays too old, pipelines can fail, so update it deliberately.

What should I check when jobs fail only on my self-hosted agents?

Check the self-hosted agent pool in Project Settings under Pipelines and Agent Pools.

Answers sourced from iifx.dev, stackoverflow.com, www.chrisneale.org

Community

Collected 48 days ago - public community threads