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 controller daemon
.\wireleap start
.\wireleap status

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

# start the socks daemon
.\wireleap socks start
.\wireleap socks status

# 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 broker.circuit.hops

# set the number of relays to be used (will auto-generate a new circuit)
.\wireleap config broker.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 broker.circuit.hops 1

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