Semaphore — Modern UI for Ansible & Terraform Automation

What it is

Semaphore provides a web-based interface for running Ansible playbooks, Terraform plans, and Bash scripts. Instead of SSH-ing into a server and running ansible-playbook manually, teams use Semaphore to manage inventories, schedule runs, track execution history, and control access through a browser.

The tool targets DevOps teams, sysadmins, and infrastructure engineers who already use Ansible or Terraform but want a shared execution environment with audit trails and role-based access. It is open source and self-hosted.

How it saves time or tokens

Running Ansible playbooks from individual developer laptops creates inconsistency: different Python versions, missing SSH keys, no execution history. Semaphore centralizes playbook execution on a server with a consistent environment, stores run history, and provides team-level access control. Scheduling recurring playbooks (patch updates, compliance checks) replaces manual cron jobs with a visual scheduler.

How to use

1. Run Semaphore with Docker:

docker run -d --name semaphore \
  -p 3000:3000 \
  -e SEMAPHORE_DB_DIALECT=bolt \
  -e SEMAPHORE_ADMIN_PASSWORD=changeme \
  -e SEMAPHORE_ADMIN_NAME=admin \
  -e SEMAPHORE_ADMIN=admin \
  semaphoreui/semaphore:latest

1. Open http://localhost:3000 and log in with the admin credentials.

1. Add your Git repository containing Ansible playbooks or Terraform configs.

1. Create a task template pointing to a playbook/plan and run it from the UI.

Example

# playbook.yml - Sample Ansible playbook managed by Semaphore
- hosts: web_servers
  become: yes
  tasks:
    - name: Update packages
      apt:
        update_cache: yes
        upgrade: safe

    - name: Ensure nginx is running
      service:
        name: nginx
        state: started
        enabled: yes

Import this playbook into Semaphore, configure the inventory, and run it from the web UI with full execution logs.

Related on TokRepo

• DevOps Tools -- Infrastructure automation and deployment tools
• Self-Hosted Solutions -- Self-hosted platforms for team operations

Common pitfalls

• Semaphore requires Ansible or Terraform installed on the server where it runs. The Docker image includes Ansible but you may need to add Terraform manually.
• The bolt database (embedded) is fine for small teams but does not scale. Use PostgreSQL or MySQL for production deployments with multiple users.
• SSH keys and credentials must be configured in Semaphore's key store. Missing or misconfigured keys are the most common cause of failed task runs.