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

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.

  • 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
  • Restart your PC before continuing.

  • Install the latest WSL v2 Linux kernel from Microsoft.

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

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

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

docker run hello-world

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, 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.

Last updated 4 months ago