Upgrade Semaphore
This page explains how to upgrade Semaphore in place and how to deal with expired certificates.
Renew expired TLS certificates
TLS certificates generated during the installation are only valid for 3 months. The certificates do not autorenew. Follow these steps to generate and install the new certificates.
-
If required, SSH into the Semaphore server
-
Go to the
semaphore-installdirectory and load thesemaphore-configused in the original installationLoad Semaphore and cloud configurationcd semaphore-install
source semaphore-config -
Re-run the certbot command and follow the on-screen instructions
Create certificates with certbotcertbot certonly --manual --preferred-challenges=dns \
-d "*.${DOMAIN}" \
--register-unsafely-without-email \
--work-dir certs \
--config-dir certs \
--logs-dir certs -
Follow the upgrade steps to Semaphore
Renew Enterprise Edition License
Semaphore server shows an warning message when the license is close to expiring or has expired already.
To renew your license, follow these steps.
-
Obtain a new license. See the how to obtain a license page for instructions
-
If required, SSH into the Semaphore server
-
Copy the new license file into the server
-
Update the
semaphore-configinside yoursemaphore-installdirectory. Update the value ofLICENSE_FILEUpdate the value of LICENSE_FILEexport LICENSE_FILE="your-new-license-file-name.txt" -
Follow the upgrade steps to Semaphore
Upgrade Semaphore
To upgrade Semaphore, you must re-run the helm upgrade command used to install it in the first place.
-
If required, SSH into the Semaphore server
-
Go to the
semaphore-installdirectory and load thesemaphore-configused in the original installationLoad Semaphore and cloud configurationcd semaphore-install
source semaphore-config -
Re-run the Helm upgrade command used in the initial installation. You may select a different
--versionargument to maintain, upgrade, or downgrade your Semaphore version. The installation usually takes between 10 and 40 minutes