Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/semaphoreui/semaphore

Modern UI and powerful API for Ansible, Terraform/OpenTofu/Terragrunt, PowerShell and other DevOps tools.
https://github.com/semaphoreui/semaphore

ansible awx ci cicd devops docker docker-ui go golang jenkins opentofu pulumi terraform terraform-ui terragrunt

Last synced: 8 days ago
JSON representation

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

Awesome Lists containing this project

README 

          
# Semaphore UI



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



[![roadmap](https://img.shields.io/badge/roadmap-gray?style=for-the-badge&logo=github)](https://github.com/orgs/semaphoreui/projects/11)

[![telegram](https://img.shields.io/badge/discord_community-510b80?style=for-the-badge&logo=discord)](https://discord.gg/5R6k7hNGcH) 

[![youtube](https://img.shields.io/badge/youtube_channel-red?style=for-the-badge&logo=youtube)](https://www.youtube.com/@semaphoreui) 



![responsive-ui-phone1](https://user-images.githubusercontent.com/914224/134777345-8789d9e4-ff0d-439c-b80e-ddc56b74fcee.png)



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



## Gratitude



Thank you, [Stefan](https://github.com/stefanux) and [steadfasterX](https://github.com/steadfasterX), for supporting the project. Your support is invaluable.



Thank you, [Thomas](https://github.com/tboerger) and [Brian](https://github.com/Omicron7), for your excellent contributions. You solved issues that no one else would have taken on.



## 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



1. **Projects** is a collection of related resources, configurations, and tasks.

2. **Task Templates** are reusable definitions of tasks that can be executed on demand or scheduled.

3. **Task** is a specific instance of a job or operation executed by Semaphore.

4. **Schedules** allow you to automate task execution at specified times or intervals.

5. **Inventory** is a collection of target hosts (servers, virtual machines, containers, etc.) on which tasks will be executed.

6. **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](https://semaphoreui.com/install/docker)

* Deploy a VM from a marketplace:

  * [AWS](https://aws.amazon.com/marketplace/pp/prodview-xavlsdkqybxtq)

  * [DigitalOcean](https://marketplace.digitalocean.com/apps/semaphore?refcode=b55d7c0077b8&action=deploy)

  * [Vultr](https://www.vultr.com/marketplace/apps/semaphore)

  * [Yandex Cloud](https://yandex.cloud/ru/marketplace/products/fastlix/semaphore)

* [Snap](http://snapcraft.io/semaphore)

* [Binary file](https://semaphoreui.com/install/binary)

* [Debian or RPM package](https://semaphoreui.com/install/binary)



### Docker



The most popular way to install Semaphore is via Docker.



```

docker run -p 3000:3000 --name semaphore \

	-e SEMAPHORE_DB_DIALECT=bolt \

	-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](https://semaphoreui.com/install/docker/) to get the ideal Docker configuration for Semaphore.



### Other Installation Methods



For more installation options, visit our [Installation page](https://semaphoreui.com/install).



## Documentation



* [User Guide](https://docs.semaphoreui.com)

* [API Reference](https://semaphoreui.com/api-docs)

* [Postman Collection](https://www.postman.com/semaphoreui)



## Awesome Semaphore



A curated list of awesome things related to Semaphore UI.



* [Ebdruplab — Ansible Collections](https://github.com/Ebdruplab/ansible-collection_ebdruplab) — Ansible modules and a role for managing Semaphore.

* [SemaphoreUI MCP Server](https://github.com/cloin/semaphore-mcp) — A Model Context Protocol (MCP) server that provides AI assistants with powerful automation capabilities for SemaphoreUI.

* [Terraform SemaphoreUI Provider](https://github.com/CruGlobal/terraform-provider-semaphoreui) — Manage Semaphore UI resources using Terraform.

* [PSSemaphore](https://github.com/robinmalik/PSSemaphore) — A PowerShell module designed to work against the Ansible Semaphore REST API.



[//]: # (* [Ansible UI Semaphore](https://github.com/morbidick/ansible-role-semaphore) — Ansible role to install and configure the Ansible UI Semaphore.)



## Contribution



* [Contribution Guide](https://github.com/semaphoreui/semaphore/blob/develop/CONTRIBUTING.md)

* [Dev Container](https://codespaces.new/semaphoreui/semaphore) (default user `admin` / `changeme`)



## License



MIT © [Denis Gukov](https://github.com/fiftin)