semaphore

Built by semaphoreui

A modern web UI for running Ansible, Terraform and scripts as a team.

Automation

About

What it does

Semaphore UI gives your infrastructure automation a home. Run Ansible playbooks, Terraform and OpenTofu plans, and shell or PowerShell scripts from a clean web interface, instead of from someone's laptop.

Every run is logged, permissions control who can run what, and schedules and notifications keep routine tasks on autopilot.

Highlights

Run Ansible, Terraform/OpenTofu, Bash and PowerShell
Projects, inventories, environments and secrets
Role-based access for teams
Scheduled runs and full task history
Notifications and a REST API

Who it's for

DevOps teams that want shared, auditable automation without a heavyweight platform.

Readme

from the project's repository

Show the full readme from GitHub

Semaphore UI

Modern UI for Ansible, Terraform/OpenTofu/Terragrunt, PowerShell and other DevOps tools.

responsive-ui-phone1

If your project has grown and deploying from the terminal is no longer feasible, then Semaphore UI is the tool you need.

Demo

Try Semaphore UI online

What is Semaphore UI?

Semaphore UI is a modern web interface for managing popular DevOps tools.

Semaphore UI allows you to:

Easily run Ansible playbooks, Terraform and OpenTofu code, as well as Bash and PowerShell scripts.
Receive notifications about failed tasks.
Control access to your deployment system.

Key Concepts

Projects is a collection of related resources, configurations, and tasks.
Task Templates are reusable definitions of tasks that can be executed on demand or scheduled.
Task is a specific instance of a job or operation executed by Semaphore.
Schedules allow you to automate task execution at specified times or intervals.
Inventory is a collection of target hosts (servers, virtual machines, containers, etc.) on which tasks will be executed.
Variable Group refers to a configuration context that holds sensitive information such as environment variables and secrets used by tasks during execution.

Getting Started

You can install Semaphore using the following methods:

Docker
Deploy a VM from a marketplace:
- AWS
- Cloudzy
- DigitalOcean
- Vultr
- Yandex Cloud
- RepoCloud
Snap
Binary file
Debian or RPM package

Docker

The most popular way to install Semaphore is via Docker.

docker run -p 3000:3000 --name semaphore \
	-e SEMAPHORE_DB_DIALECT=sqlite \
	-e SEMAPHORE_ADMIN=admin \
	-e SEMAPHORE_ADMIN_PASSWORD=changeme \
	-e SEMAPHORE_ADMIN_NAME=Admin \
	-e SEMAPHORE_ADMIN_EMAIL=admin@localhost \
	-d semaphoreui/semaphore:latest

We recommend using the Container Configurator to get the ideal Docker configuration for Semaphore.

Other Installation Methods

For more installation options, visit our Installation page.

Documentation

Awesome Semaphore

A curated list of awesome things related to Semaphore UI.

Ebdruplab — Ansible Collections — Ansible modules and a role for managing Semaphore.
SemaphoreUI MCP Server — A Model Context Protocol (MCP) server that provides AI assistants with powerful automation capabilities for SemaphoreUI.
Terraform SemaphoreUI Provider — Manage Semaphore UI resources using Terraform.
PSSemaphore — A PowerShell module designed to work against the Ansible Semaphore REST API.

Contribution

Contribution Guide
Dev Container (default user admin / changeme)