https://github.com/semaphoreui/semaphore

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

ansible awx ci cicd devops docker docker-ui jenkins opentofu terraform terraform-ui

Last synced: 6 days ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/semaphoreui/semaphore
• Owner: semaphoreui
• License: mit
• Created: 2014-08-23T22:43:31.000Z (over 10 years ago)
• Default Branch: develop
• Last Pushed: 2024-10-28T11:25:34.000Z (6 months ago)
• Last Synced: 2024-10-29T12:29:28.401Z (6 months ago)
• Topics: ansible, awx, ci, cicd, devops, docker, docker-ui, jenkins, opentofu, terraform, terraform-ui
• Language: Go
• Homepage: https://semaphoreui.com
• Size: 18.3 MB
• Stars: 10,527
• Watchers: 226
• Forks: 1,063
• Open Issues: 653
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

• awesome-starz - semaphoreui/semaphore - Modern UI and powerful API for Ansible, Terraform, OpenTofu, PowerShell and other DevOps tools. (Go)
• awesome-starred - semaphoreui/semaphore - Modern UI and powerful API for Ansible, Terraform, OpenTofu, PowerShell and other DevOps tools. (Go)
• awesome-starred - semaphoreui/semaphore - Modern UI and powerful API for Ansible, Terraform, OpenTofu, PowerShell and other DevOps tools. (Go)
• awesome-repositories - semaphoreui/semaphore - Modern UI and powerful API for Ansible, Terraform, OpenTofu, PowerShell and other DevOps tools. (Go)
• stars - semaphore
• stars - semaphore
• awesome-rainmana - semaphoreui/semaphore - Modern UI and powerful API for Ansible, Terraform, OpenTofu, PowerShell and other DevOps tools. (Go)
• definitive-opensource - Semaphore
• StarryDivineSky - semaphoreui/semaphore

README

        
# Semaphore UI

Modern UI for Ansible, Terraform, OpenTofu, 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 excellent contriubutions. You solved issues that no one else would have taken on.

## Live Demo

Try the latest version of Semaphore at [https://portal.semaphoreui.com](https://portal.semaphoreui.com).

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

* [SaaS](https://portal.semaphoreui.com)

* 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.

### SaaS

We offer a SaaS solution for using Semaphore UI without installation. Check it out at [Semaphore Cloud](https://portal.semaphoreui.com).

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

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

[![sponsor](https://img.shields.io/badge/become_a_sponsor-d9c7ff?style=for-the-badge&logo=github-sponsors)](https://github.com/sponsors/semaphoreui) [![ko-fi](https://img.shields.io/badge/buy_me_a_coffee-0ba0e0?style=for-the-badge&logo=kofi)](https://ko-fi.com/fiftin) [![patreon](https://img.shields.io/badge/become_a_patreon-teal?style=for-the-badge&logo=patreon)](https://www.patreon.com/semaphoreui)