Skip to main content
Version: Enterprise Edition v1.5

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.

  1. If required, SSH into the Semaphore server

  2. Go to the semaphore-install directory and load the semaphore-config used in the original installation

    Load Semaphore and cloud configuration
    cd semaphore-install
    source semaphore-config
  3. Re-run the certbot command and follow the on-screen instructions

    Create certificates with certbot
    certbot certonly --manual --preferred-challenges=dns \
    -d "*.${DOMAIN}" \
    --register-unsafely-without-email \
    --work-dir certs \
    --config-dir certs \
    --logs-dir certs
  4. 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.

  1. Obtain a new license. See the how to obtain a license page for instructions

  2. If required, SSH into the Semaphore server

  3. Copy the new license file into the server

  4. Update the semaphore-config inside your semaphore-install directory. Update the value of LICENSE_FILE

    Update the value of LICENSE_FILE
    export LICENSE_FILE="your-new-license-file-name.txt"
  5. 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.

  1. If required, SSH into the Semaphore server

  2. Go to the semaphore-install directory and load the semaphore-config used in the original installation

    Load Semaphore and cloud configuration
    cd semaphore-install
    source semaphore-config
  3. Re-run the Helm upgrade command used in the initial installation. You may select a different --version argument to maintain, upgrade, or downgrade your Semaphore version. The installation usually takes between 10 and 40 minutes

See also​