Documentation / CLI Switch documentation
Browse documentation

Installation

Windows

Install the native pwrp.exe package on Windows 10, Windows 11, or Windows Server.

1. Download the ZIP

Open the CLI downloads page and choose the Windows package for your computer:

  • x86-64 / AMD64 for most Intel and AMD computers.
  • ARM64 for Windows on ARM devices.

2. Add pwrp to your PATH

  1. Extract the downloaded ZIP.
  2. Create a permanent folder such as C:\Users\your-name\bin.
  3. Move pwrp.exe into that folder.
  4. Open Edit environment variables for your account from the Start menu.
  5. Edit the user Path, add the folder, and save.
  6. Open a new PowerShell window.

If Windows marks the downloaded executable as blocked, right-click pwrp.exe, open Properties, select Unblock, and apply the change.

3. Verify and sign in

PowerShell
pwrp version
pwrp login

The login command displays a short code and opens the Portwarp approval page. Approve the device in your browser, then return to PowerShell.

Connect a tunnel

PowerShell
pwrp tunnels
pwrp connect

Use pwrp connect --all --save --detach when you want every enabled tunnel to run in the background and reconnect automatically with the daemon.

Start automatically

Portwarp can create a per-user startup task. Administrator privileges are not required:

PowerShell
pwrp connect --all --save --detach
pwrp service enable
pwrp service status

Update or remove

Run pwrp update to install the newest CLI release. To remove the CLI, first disable startup, then delete pwrp.exe:

PowerShell
pwrp service disable
pwrp logout

pwrp logout stops local tunnels and removes the saved login before you delete the executable.