# Semaphore

Generated on 24 Mar 2025 from [the Semaphore catalog page](https://marketplace.digitalocean.com/apps/semaphore)

Semaphore UI is a powerful web-based interface for managing Ansible and OpenTofu automation with ease. With just one click, you get a ready-to-use environment to run playbooks, manage inventories, and streamline DevOps workflows. It includes a preinstalled NGINX reverse proxy and supports secure access with SSL. Ideal for teams and solo developers looking to simplify and visualize their Ansible and OpenTofu operations.

## Software Included

| Package | Version | License |
|---|---|---|
| Semaphore UI | 2.13.1 | MIT |

## Creating an App using the Control Panel

Click the **Deploy to DigitalOcean** button to create a Droplet based on this 1-Click App. If you aren’t logged in, this link will prompt you to log in with your DigitalOcean account.

[![Deploy to DO](https://www.deploytodo.com/do-btn-blue.svg)](https://cloud.digitalocean.com/droplets/new?image=semaphore)

## Creating an App using the API

In addition to creating a Droplet from the Semaphore 1-Click App using the control panel, you can also use the [DigitalOcean API](https://docs.digitalocean.com/reference/api). As an example, to create a 4GB Semaphore Droplet in the SFO2 region, you can use the following `curl` command. You need to either save your [API access token](https://docs.digitalocean.com/reference/api/create-personal-access-token/index.html.md) to an environment variable or substitute it in the command below.

```shell
curl -X POST -H 'Content-Type: application/json' \
         -H 'Authorization: Bearer '$TOKEN'' -d \
        '{"name":"choose_a_name","region":"sfo2","size":"s-2vcpu-4gb","image":"semaphore"}' \
        "https://api.digitalocean.com/v2/droplets"
```

## Getting Started After Deploying Semaphore

1. Connect to the server via SSH: ssh root@your\_droplet\_public\_ipv4
2. Create an admin user by running the following command:

```
semaphore user add \
--admin \
--login admin \
--name Admin \
--email admin@example.com \
--password changeme
```

3. Open https://your\_droplet\_public\_ipv4 in your browser and log in to Semaphore UI using the admin credentials.