Project

General

Profile

Deploy SemaphoreUI

Ansible
08/20/2025

Deploy SemaphoreUI

Use the following steps to deploy deploy SemaphoreUI. Use the same steps to update an existing deployment.

Update Version

Edit the semaphoreui_setup_version variable located in inventory/ansible/group_vars/semaphore/main.yml to the version of SemaphoreUI to update to.

semaphoreui_setup_version: "2.16.17"

The SemaphoreUI releases are available in https://github.com/semaphoreui/semaphore/releases.

Commit the changes.

Login to an Ansible Control Node

Login to an Ansible control node and set the following to prep the playbook execution.

cd /ansible/dev/ansible
source /opt/python_3.12/bin/activate
INV=inventory/ansible/inventory.ini

Deploy the Update

Execute the following to deploy SemaphoreUI.

ansible-playbook -i $INV -k playbooks/plex/deploy_semaphoreui.yml

Verify Update

Verify the new version has been installed successfully by opening, https://semaphore.refol.us/ in a browser. Login as an admin. Click on the Admin link to view the version number. This version should match the upgraded version.

Files