Twingate

Twingate Connectors run in Docker containers. On Windows there are two options for running Docker.

  1. For Windows 10 64-bit Pro, Enterprise, and Education Docker Desktop Community Edition is available for those platforms at no cost. Specific installation instructions are detailed below.
  2. Windows Server only supports Docker Enterprise. Detailed installation documentation is available.

Installing Docker on Windows 10

The following steps will allow you to set up Docker on Windows 10 and run Linux-based containers. Windows 10, version 2004 (Build 19041) or higher is required.

  1. From PowerShell (requires Run as administrator), enable Windows Subsystem for Linux (WSL) functionality.
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
  1. Restart your PC before continuing.

  2. Install the latest WSL v2 Linux kernel from Microsoft.

  3. From PowerShell (requires Run as administrator), set WSL v2 as the default version.

wsl --set-default-version 2
  1. Install Docker Desktop CE from the Docker website.

  2. Start Docker and verify that everything is working using the following command:

docker run hello-world
  1. Follow the Twingate Connector deployment instructions to deploy a new Connector.

Additional information on WSL configuration can be found on Microsoft's website.

Known Limitations

Because of limitations in the Docker for Windows networking stack, it's not possible to connect to the same Windows device running the Connector container using that device's IP address on the local network.

For example, if your Windows host running the Connector container has the IP address 192.168.1.15, adding this IP address as a Resource in Twingate will not allow you to connect because of limitations in Docker. Instead, you must use the special Docker DNS name host.docker.internal if you wish to connect to services on the same host. More details are on the Docker website.

Updated 2 months ago


Windows


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.