Systemd Service

If you are running Twingate Connectors as a native Linux systemd service, the instructions below cover how to upgrade Connectors. Please keep in mind the best practices for upgrading detailed in Upgrading Connectors to avoid downtime for your users.

See the Linux systemd deployment documentation for more information on using our systemd service.

Checking the Connector Version

If you'd like to check the currently running version of a Connector running via systemd, you can do so using the following command:

twingate-connector -v

The latest build version number and other update notes are available in the Connector Release Notes.

Ubuntu (apt)

The following steps will upgrade the twingate-conector package and service using apt.

sudo apt update
sudo apt install -yq twingate-connector
sudo systemctl restart twingate-connector

Fedora and CentOS (dnf)

The following steps will upgrade the twingate-connector package and service using dnf.

sudo dnf update
sudo dnf --best install twingate-connector
sudo systemctl restart twingate-connector

Automated connector updates

❗️

Staggering connector updates

To avoid users experiencing downtime during connector updates, we recommend the following:

  • Scheduling automatic updates during an off-peak time for your typical usage patterns.
  • Always deploying two or more Connectors in each Remote Network so that any one Connector can be updated without introducing downtime for users.
  • Ensuring that multiple Connectors in the same Remote Network are not updated at the same time. Staggering update schedules will avoid this.

It is possible to use standard Linux tools to automate regular updating of Connectors. For example, for Ubuntu Linux the following will create a weekly cron job to update and restart the Connector.

sudo tee -a /etc/cron.weekly/update-twingate-connector > /dev/null <<EOF
#!/bin/bash
sudo  -- sh -c 'apt update && apt install -yq twingate-connector && systemctl restart twingate-connector'
EOF
sudo chmod +x /etc/cron.weekly/update-twingate-connector

Did this page help you?