Skip to main content
Version: Enterprise Edition v1.5 (latest)

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