Semaphore UI

Web UI to run Ansible, Terraform, OpenTofu and scripts

  • ghcr.io/hsinghhira/semaphore:latest
  • v2.20.24
  • Updated 21 Nov 2026
  • port 6778
  • amd64 · arm64
  • Developer
  • 14.4k stars

Screenshots

Semaphore UI screenshot 1: Task history

Open the app

Web UI

http://localhost:6778/

API

http://localhost:6778/api/ping

About Semaphore UI

Semaphore UI runs your Ansible playbooks, Terraform and OpenTofu plans, and Bash, PowerShell and Python scripts from a web page. Keep your inventories, keys and repositories in one place, run tasks with a click or on a schedule, and see every run's log. It uses a built-in SQLite database, so it is one container with nothing else to set up.

Features

  • Ansible, Terraform, OpenTofu, Bash, PowerShell and Python tasks
  • Projects with inventories, keys, repositories and variables
  • Schedules, and a history with the log of every run
  • Alerts by email, Telegram, Slack, Teams and more
  • Teams with roles, LDAP and OIDC sign-in
  • An API to start tasks from anywhere

How to use

  1. Open Semaphore UI from your dashboard.
  2. Sign in with the user name and password from the app's logs (the box marked CREDENTIALS).
  3. Make a project, then add a key, a repository and an inventory.
  4. Add a task template for your playbook or script.
  5. Click Run, and watch its log.

Before you install

You can install it as it is and open it at http://[ZIMAOS-IP-ADDRESS]:6778. The admin is SEMAPHORE_ADMIN (admin unless you change it) with a password made on first start, shown in the app's logs in the box marked CREDENTIALS and saved in /DATA/AppData/semaphore/data/.admin_password. The key that encrypts your saved keys is made for you too. Email and chat alerts, LDAP and the other settings are in the Variables tab and are added in the app settings. It is ready in about a minute.

The settings in the first table are already in the app settings. To use any other one, open the app settings, add the variable with your value, save, and the app restarts with it. A setting you leave out uses its default.

In the app settings

VariableDefault valueDescription
TZ$TZYour time zone. It is filled in from your ZimaOS time zone and used for schedules.
SEMAPHORE_ADMINadminThe admin's user name. Only used on the first start.
SEMAPHORE_ADMIN_EMAILadmin@localhostThe admin's email. Only used on the first start.
SEMAPHORE_ADMIN_PASSWORD—The admin's password. Leave it empty and one is made for you: it is shown in the app's logs, in the box marked CREDENTIALS. Only used on the first start.

First admin

VariableDefault valueDescription
SEMAPHORE_ADMIN_NAMESemaphore AdminThe admin's full name. Only used on the first start.

Server

VariableDefault valueDescription
SEMAPHORE_WEB_ROOT—The address you open Semaphore at, like http://192.168.1.20:6778. Used in links in alerts. Only read on the first start.
SEMAPHORE_ACCESS_KEY_ENCRYPTION—The key saved keys and passwords are encrypted with. It is made on first start and kept in /data/secrets.env. Only set it to move an old install.
SEMAPHORE_MAX_PARALLEL_TASKS0How many tasks may run at once. 0 means no limit.

Email alerts

VariableDefault valueDescription
SEMAPHORE_EMAIL_ALERTfalseSet to true to send alerts by email.
SEMAPHORE_EMAIL_SENDER—The address alerts are sent from.
SEMAPHORE_EMAIL_HOST—Your email server, like smtp.gmail.com.
SEMAPHORE_EMAIL_PORT—Your email server port, usually 587 or 465.
SEMAPHORE_EMAIL_USERNAME—The user name for your email server.
SEMAPHORE_EMAIL_PASSWORD—The password for your email server.
SEMAPHORE_EMAIL_SECUREfalseSet to true to use TLS.

Other alerts

VariableDefault valueDescription
SEMAPHORE_TELEGRAM_ALERTfalseSet to true to send alerts to Telegram.
SEMAPHORE_TELEGRAM_CHAT—The Telegram chat ID.
SEMAPHORE_TELEGRAM_TOKEN—Your Telegram bot's token.
SEMAPHORE_SLACK_ALERTfalseSet to true to send alerts to Slack.
SEMAPHORE_SLACK_URL—Your Slack webhook address.

LDAP

VariableDefault valueDescription
SEMAPHORE_LDAP_ACTIVATEDnoSet to yes to sign in with LDAP. Only read on the first start.
SEMAPHORE_LDAP_HOST—Your LDAP server.
SEMAPHORE_LDAP_PORT—Its port, usually 389 or 636.
SEMAPHORE_LDAP_DN_BIND—The account Semaphore searches with.
SEMAPHORE_LDAP_PASSWORD—Its password.
SEMAPHORE_LDAP_DN_SEARCH—Where to look for users, like dc=example,dc=com.
docker-compose.yml
name: semaphore

services:
  semaphore:
    image: ghcr.io/hsinghhira/semaphore:latest
    container_name: semaphore
    restart: unless-stopped
    stop_grace_period: 30s
    network_mode: bridge
    environment:
      - TZ=$TZ
      - SEMAPHORE_ADMIN=admin
      - SEMAPHORE_ADMIN_EMAIL=admin@localhost
      - SEMAPHORE_ADMIN_PASSWORD=
    ports:
      - target: 3000
        published: "6778"
        protocol: tcp
    volumes:
      - type: bind
        source: /DATA/AppData/$AppID/data
        target: /data
        bind:
          create_host_path: true
    healthcheck:
      test: ["CMD", "wget", "-q", "-O", "/dev/null", "http://127.0.0.1:3000/api/ping"]
      interval: 30s
      timeout: 10s
      retries: 5
      start_period: 120s
    deploy:
      resources:
        limits:
          cpus: "2.00"
          memory: 2048M
        reservations:
          cpus: "0.05"
          memory: 128M
    labels:
      icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/semaphore/icon.png
    x-casaos:
      id: com.icestore.semaphore
      envs:
        - container: TZ
          description:
            en_US: >-
              Your time zone. It is filled in from your ZimaOS time zone and
              used for schedules.
        - container: SEMAPHORE_ADMIN
          description:
            en_US: >-
              The admin's user name. Only used on the first start.
        - container: SEMAPHORE_ADMIN_EMAIL
          description:
            en_US: >-
              The admin's email. Only used on the first start.
        - container: SEMAPHORE_ADMIN_PASSWORD
          description:
            en_US: >-
              The admin's password. Leave it empty and one is made for you:
              it is shown in the app's logs, in the box marked CREDENTIALS.
              Only used on the first start.
      ports:
        - container: "3000"
          description:
            en_US: Semaphore UI web UI and API, published on host as 6778
      volumes:
        - container: /data
          description:
            en_US: >-
              Everything Semaphore keeps: its config (config), the SQLite
              database (db), cloned repositories (tmp) and this install's
              own keys (secrets.env, .admin_password). Back it up.

x-casaos:
  id: com.icestore.semaphore
  architectures:
    - amd64
    - arm64
  main: semaphore
  author: HSinghHira
  category: Developer
  developer: Semaphore UI
  icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/semaphore/icon.png
  thumbnail: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/semaphore/screenshot-1.png
  screenshot_link:
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/semaphore/screenshot-1.png
  title:
    en_US: Semaphore UI
  tagline:
    en_US: Web UI to run Ansible, Terraform, OpenTofu and scripts
  description:
    en_US: >-
      Semaphore UI runs your Ansible playbooks, Terraform and OpenTofu
      plans, and Bash, PowerShell and Python scripts from a web page. Keep
      your inventories, keys and repositories in one place, run tasks with
      a click or on a schedule, and see every run's log. It uses a built-in
      SQLite database, so it is one container with nothing else to set up.


      **Features**


      - Ansible, Terraform, OpenTofu, Bash, PowerShell and Python tasks

      - Projects with inventories, keys, repositories and variables

      - Schedules, and a history with the log of every run

      - Alerts by email, Telegram, Slack, Teams and more

      - Teams with roles, LDAP and OIDC sign-in

      - An API to start tasks from anywhere


      **How to use?**


      1. Open Semaphore UI from the ZimaOS dashboard.

      2. Sign in with the user name and password from the app's logs (the
         box marked CREDENTIALS).

      3. Make a project, then add a key, a repository and an inventory.

      4. Add a task template for your playbook or script.

      5. Click Run, and watch its log.
  tips:
    before_install:
      en_US: >-
        1. More settings, like email alerts and LDAP or OIDC sign-in, are
           listed on the Semaphore UI page at
           https://icestore.hsinghhira.me/app/semaphore/ (Variables tab).
           You can add them now or later in the app settings.


        2. Start the installation. It is ready in about a minute.


        3. Open the app's logs. Find the box marked CREDENTIALS. It has the
           user name and password.


        4. Open http://[ZIMAOS-IP-ADDRESS]:6778 and sign in.
  index: /
  port_map: "6778"
  scheme: http
  is_uncontrolled: false
  version: "v2.20.24"
  update_at: "2026-11-21"
  release_notes:
    en_US: |-
      - First IceStore release, on port 6778
      - Built on semaphoreui/semaphore v2.20.24, with SQLite as the database
      - Each install makes its own access key encryption secret and admin password on first start; the login is in the CREDENTIALS box in the logs
  repo: "https://github.com/semaphoreui/semaphore"
  support: "https://github.com/semaphoreui/semaphore/issues"
  docs: "https://docs.semaphoreui.com/"

Install Semaphore UI

Something not working with Semaphore UI?

Report it so it gets fixed, or ask for an app that is not here yet.

More Developer apps

See all