Skip to content

Setting up Warpdrive on Windows

hexafluoride edited this page Jan 7, 2019 · 2 revisions

After you've set up your Warpdrive server, it is time to configure your client to connect to your server.

Install the TAP-Windows Adapter

Please download and install the TAP-Windows Adapter, available here. The installer might ask you to reboot your computer.

Finding out your server's endpoint

On your server's configuration, a number of listeners should be specified, like so.

"network.listen": ["ws://127.0.0.1:1235", "udp://0.0.0.0:80"]

Pick any of the reachable listeners and put them in the "network.connect" configuration variable, either like so in a configuration file:

"network.connect": "udp://publicly.reachable.ip.address:80"

or like so on the command line:

warpdrive --connect udp://publicly.reachable.ip.address:80

Assigning an IP to your client

Warpdrive currently doesn't support automatic allocation of IP addresses. For now, keep track of your clients' IP usage and assign an unused IP to your new client. After you've assigned a new IP to your client in its configuration, either like so in a configuration file:

"network.tun.addr": "10.0.0.20/8"

or like so on the command line:

warpdrive --ip 10.0.0.20/8

You still need to configure the TAP-Windows Adapter to use that IP. Open the Network and Sharing Center, navigate to "Change adapter settings", and find the TAP-Windows Adapter V9.

After you find your adapter, right click it and click Properties. You'll be greeted by this window:

Find Internet Protocol Version 4 (highlighted in the picture), and click Properties again. In the window that opens:

Set both options to "Use the following...". Fill out the sections with information that pertains to your networking setup. Example values for a 10.0.0.0/8 subnet (the most common configuration) are:

IP address: <enter your IP address>
Subnet mask: 255.0.0.0
Default gateway: 10.0.0.1

Then, enter a valid DNS configuration. In the screenshot, the Google Public DNS service is used, but you are free to configure these however you wish.

After you're done with all of these steps, you should have a working Warpdrive configuration. A side note, if you're using route autoconfiguration (the recommended default), Windows route handling can be a bit unstable. If you're having trouble with your Internet not working or not going through the Warpdrive tunnel, try:

  • restarting Warpdrive and letting it configure routes again
  • disabling/reenabling the network adapters (both the TAP-Windows one and the one you use to connect to the Internet)