semaphore README

The project's README from github.com/semaphoreui/semaphore. As one markdown file: README.md.

Semaphore UI

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

Dev

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:

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

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.

Contribution

License

MIT © Denis Gukov

semaphore (semaphoreui/semaphore)

jenkins
Searching Database…

14.3K ·GitHub
What is this?Semaphore UI is a modern web interface and API for running and managing Ansible playbooks, Terraform/OpenTofu/Terragrunt, PowerShell and Bash scripts, so you don't have to deploy from a terminal anymore.
Is this a CI/CD runner or more like AWX for Ansible?It's a self-hosted server app: you define Projects, Task Templates, Inventories and Variable Groups through a web UI, and it runs those tasks (Ansible, Terraform, scripts) on demand or on a schedule.
How do I get it running?The most popular way is via Docker (a Container Configurator helps generate the ideal config), but it's also available as a Snap, binary file, Debian/RPM package, or as a one-click VM deploy on marketplaces like AWS, DigitalOcean or Vultr.
Any install pitfalls I should know about?The Docker setup needs some configuration tuning, which is why the project points users to a dedicated Container Configurator tool rather than a plain docker run command.
How does Semaphore control access to deployments?It lets you control access to your deployment system as part of its core features, though the README doesn't detail the exact permission model.
Can I try it before installing?Yes, there's an online demo you can use to try Semaphore UI without installing it.
Is there an MCP server or AI integration for Semaphore?Yes, the community maintains a SemaphoreUI MCP Server that lets AI assistants trigger Semaphore automation, plus a Terraform provider and PowerShell module for managing it programmatically.
What are Variable Groups used for?Variable Groups hold sensitive configuration like environment variables and secrets that tasks use during execution, keeping credentials separate from task definitions.
What are similar projects?forge, spug, jenkins, floci, encore, Jenkins-Zero-To-Hero, awx, opentofu
Size
85.6 MB
Stars
14.3K
Age
12y
Commits · 90 Days