Systemd Service Upgrades
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 updatesudo apt install -yq twingate-connectorsudo systemctl restart twingate-connector
Fedora and CentOS (dnf
)
The following steps will upgrade the twingate-connector
package and service using dnf
.
sudo dnf updatesudo dnf --best install twingate-connectorsudo 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/bashsudo -- sh -c 'apt update && apt install -yq twingate-connector && systemctl restart twingate-connector'EOFsudo chmod +x /etc/cron.weekly/update-twingate-connector
Last updated 9 months ago