Skip to content

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

License

Notifications You must be signed in to change notification settings

semaphoreui/semaphore

Repository files navigation

Semaphore UI

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

roadmap telegram youtube

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.

Gratitude

Thank you, Stefan and steadfasterX, for supporting the project. Your support is invaluable.

Thank you, Thomas and Brian, 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.

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
  • SaaS (Semaphore Cloud)
  • Deploy a VM from a marketplace (AWS, DigitalOcean, etc.)
  • 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=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 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.

Other Installation Methods

For more installation options, visit our Installation page.

Documentation

Contribution

License

MIT © Denis Gukov

sponsor ko-fi patreon