Skip to content

SOP 001: Install ngrok on Windows ​

Fresh
FieldValue
SOP IDSOP-001
Version1.0
StatusActive
Last Updated2026-02-13

Purpose ​

Install the ngrok agent CLI on a Windows machine and verify it is working correctly.

Prerequisites ​

  • Windows 10 or 11 (64-bit or 32-bit)
  • Internet access
  • Administrator privileges (for Windows App Store method)

Procedure ​

  1. Open the Microsoft Store app
  2. Search for ngrok
  3. Click Install
  4. Wait for installation to complete

Method B: Direct Download ​

  1. Visit download.ngrok.com
  2. Download the Windows ZIP file for your architecture (64-bit or 32-bit)
  3. Extract the ZIP to a permanent location, e.g. C:\ngrok\
  4. Add the folder to your system PATH:
    • Press Win + X > System > Advanced system settings
    • Click Environment Variables
    • Under System variables, select Path > Edit
    • Click New and add C:\ngrok\
    • Click OK on all dialogs

Verification ​

Open a new terminal (Command Prompt or PowerShell) and run:

bash
ngrok help

You should see ngrok's help text with available commands.

Verification Checklist ​

  • [ ] ngrok is installed
  • [ ] ngrok help prints help text
  • [ ] ngrok version is displayed with ngrok version

System Requirements ​

ResourceValue
Memory64MB minimum, 128MB recommended
Disk25MB
CPUNo requirement
OSWindows 64-bit or 32-bit (x86-64, x86)

Troubleshooting ​

IssueSolution
ngrok not recognizedEnsure the folder is in your PATH and open a new terminal
Download blocked by antivirusAdd an exception for the ngrok executable
Permission deniedRun terminal as Administrator

See Also ​

Built with VitePress + Claude RAG Chat