Getting started on Windows

Table of contents

This quickstart guide will walk you through the process of installing the Wireleap client software on Windows, importing accesskeys for the Wireleap Libre network, and getting started.

For more detailed information, please refer to the client documentation.

Installation

## in a powershell

# download, verify and install
powershell -nop -c "iex(New-Object Net.WebClient).DownloadString('https://get.wireleap.com/windows'); Get-Wireleap -Dir $env:USERPROFILE\wireleap"
cd ~\wireleap

# start the socks and broker daemon
.\wireleap start
.\wireleap info

Accesskeys

Libre accesskeys are valid for 24 hours of access. Feel free to generate fresh keys as needed:

# generate and import a new accesskey (valid for 24h)
.\wireleap import "https://libre.wireleap.com/accesskeys"

Routing specific traffic

Any application that supports the SOCKSv5 protocol can be configured to route its traffic via the connection broker. As there is no standard across applications for proxy settings, some wrapper scripts are included.

# list available exec commands
.\wireleap exec list

# example exec usage
.\wireleap exec curl URL
.\wireleap exec git clone URL
.\wireleap exec firefox [URL]
.\wireleap exec google-chrome [URL]
.\wireleap exec chromium-browser [URL]

Tip: Customize the circuit

The circuit defines which relays will be used to transmit traffic. A circuit is generated by randomly selecting from the available relays.

# trigger new circuit generation
.\wireleap restart

# display the number of relays to be used in the circuit
.\wireleap config circuit.hops

# set the number of relays to be used (will auto-generate a new circuit)
.\wireleap config circuit.hops 3

Additionally, a whitelist may be specified allowing the creation of an exact circuit when coupled with a specific amount of hops, or a more general only use these relays.

# set the number of circuit hops
.\wireleap config circuit.hops 1

# set a whitelist of relays to use
.\wireleap config circuit.whitelist "wireleap://relay1.example.com:13490"