HomeDocumentation

Linux

Suggest Edits

Supported distributions

The Twingate Linux Client currently supports the following Linux distributions for x86/AMD64-based devices. If you use a different distribution or have feedback, please contact us.

  • Ubuntu (18.04 LTS or later)
  • Debian (9 or later)
  • Fedora (33 or later)
  • CentOS (Stream 8 or later)
  • Arch Linux
  • ThinPro

System Prerequisites

  • The Linux Client requires either systemd-resolved service to be enabled/running or NetworkManager service to be configured and enabled/running.
  • A notification service is required for interactive user authentication. If a notification service is not available, the Client will provide instructions for receiving a console-based notification feed.

Installation and Setup

🚧

Installation is supported on x86/AMD64 based devices. At this time ARM based devices are not supported for installation.

Installation
The following command will download and install the Linux Client on any supported Linux distribution.
Note: Headless Mode is available for server, services, or container instances. 

curl -s https://binaries.twingate.com/client/linux/install.sh | sudo bash

Setup
Once installation completes, you need to configure the Linux Client by running the following command:

sudo twingate setup

Usage notes

We recommend that you start the Linux Client from a terminal window within a desktop environment so that you can respond to authentication notifications. The Linux Client does not have a graphical interface, and is operated with the basic CLI commands below.

Command

Description

sudo twingate setup

Interactively configure the Twingate Client.

twingate start

Start the Twingate Client.

twingate status

Output Twingate Client status.

twingate stop

Stop the Twingate Client.

twingate resources

Show available Resources for the authenticated user.

twingate help

Show usage information.

🚧

User permissions when starting Twingate

It's important that you start the Linux Client without elevated permissions—ie. twingate start—in order to receive desktop notifications required for authentication. Desktop notifications are using to alert the user when authentication is required to access protected Resources. Running sudo twingate start will result in these notifications being hidden from the logged in user.

Advanced CLI commands are also available depending on the configuration or usage needs.

Command

Description

sudo twingate config

To manually change a Client configuration setting, use twingate config [setting] [value].

Example settings that can be configured:
network, autostart, save-auth-data, log-level

twingate desktop-start

Start desktop notifications for Twingate authentication requests.

/usr/bin/twingate-notifier console

Authenticate Twingate Client without desktop notifications.

Note: Copy the URL returned and paste into a browser to authenticate the Twingate Client.

Manual Client installation via package management

If you wish to add the Twingate Linux Client repositories manually, follow the steps below.

Debian

echo "deb [trusted=yes] https://packages.twingate.com/apt/ /" | tee /etc/apt/sources.list.d/twingate.list
apt update -yq
apt install -yq twingate
# After installation, configure the client by running: sudo twingate setup

RPM

dnf install -y 'dnf-command(config-manager)'
dnf config-manager --add-repo https://packages.twingate.com/rpm/
dnf config-manager --save --setopt=packages.twingate.com_rpm_.gpgcheck=0
dnf install -y twingate
# After installation, configure the client by running: sudo twingate setup

Pacman (Arch Linux)

curl https://binaries.twingate.com/client/linux/ARCH/latest/twingate-amd64.pkg.tar.zst --output twingate.pkg.tar.zst
pacman -Syy
pacman -U --noconfirm twingate.pkg.tar.zst
# After installation, configure the client by running: sudo twingate setup

Updated 19 days ago

Did this page help you?