Self-hosted agents

Product · Self-hosted / on-prem software · Sales by Semaphore

Run CI/CD jobs on your own infrastructure with full control over hardware and security.

Open-source CI/CD agents for running Semaphore jobs on your own Linux, macOS, Windows, or Kubernetes infrastructure.

Price
From 0 USD
Languages
English

Category: DevOps

Platforms
Linux, macOS, Windows, Kubernetes, AWS
Integrations
AWS, Kubernetes, GitHub, Bitbucket, GitLab
APIs and SDKs
Semaphore Public API, MCP server for coding agents
License
Open Source (Apache 2.0)
Supported OS
Linux, macOS, Windows, Kubernetes
Connection protocol
Outbound HTTPS (Port 443)
  • Run jobs on Linux, macOS, Windows, or Kubernetes machines
  • Outbound-only HTTPS connections with no inbound ports required
  • Autoscaling to zero when no work is in the queue
  • Supports specialized hardware like GPUs and private networks

Overview

Semaphore Self-hosted agents are open-source programs that allow businesses to run CI/CD jobs on their own infrastructure while Semaphore handles scheduling and the UI. This solution is designed for teams that require specialized hardware like GPUs, access to private networks, or specific operating system images. The agents support Linux, macOS, Windows, and Kubernetes environments and connect to Semaphore via outbound-only HTTPS requests. By using self-hosted agents, organizations can scale their build capacity to zero when idle and mix their own machines with Semaphore-managed cloud machines in a single pipeline. The agent code is public on GitHub and licensed under Apache 2.0.

Infrastructure Control

  • Cross-platform support: The agent is a small open-source program that runs on Linux, macOS, Windows, or Kubernetes machines.
  • Outbound-only connection: The agent only makes outbound HTTPS connections to Semaphore, requiring no inbound ports to be opened in the firewall.
  • Scale to zero: Autoscaling can start agents when jobs queue and scale them down to zero when there is no work.
  • Hybrid execution: Users can mix Semaphore-managed machines and self-hosted agents within the same pipeline on a per-block basis.

Environment Customization

  • Private network access: Run jobs on private networks or behind firewalls with direct access to internal resources.
  • Custom hardware usage: Utilize specialized hardware such as GPUs or large machine types not available in standard cloud runners.
  • Custom images and caching: Maintain full control over machine images, pre-installed dependencies, and local caching strategies.
  • Encrypted communication: Traffic between the self-hosted agent and Semaphore is encrypted over HTTPS.

Use cases

  • Teams use self-hosted agents to run machine learning workloads on specialized GPU hardware.
  • Enterprises run CI/CD jobs behind their company firewall to access private databases and internal services.
  • Developers mix managed cloud machines for standard builds with self-hosted agents for specialized macOS or Windows testing.
  • Organizations reduce infrastructure costs by autoscaling their own build runners to zero when no jobs are active.

Specifications

Deployment
Self-hosted on Linux, macOS, Windows, or Kubernetes; AWS via agent AWS stack
Platforms
Linux, macOS, Windows, Kubernetes, AWS
Integrations
AWS, Kubernetes, GitHub, Bitbucket, GitLab
APIs and SDKs
Semaphore Public API, MCP server for coding agents
License
Open Source (Apache 2.0)
Supported OS
Linux, macOS, Windows, Kubernetes
Connection protocol
Outbound HTTPS (Port 443)
Cloud integration
AWS via agent AWS stack
Kubernetes deployment
Agent Helm chart
Scaling capability
Autoscaling to zero

How it works

  1. Create an agent type: Create a new agent type within your Semaphore organization to define the environment.
  2. Start the agent: Install the open-source agent program on your machine and start it using its unique token.
  3. Configure the pipeline: Point a pipeline or a single block at the newly created agent type in your YAML configuration.

Pricing

Self-Hosted machine time
$0.0025 /min any machine

Start free

Added by AntSpace from public sources (semaphore.io).

Related

More products by Semaphore