SOP 001: Install ngrok on Windows ​
Fresh| Field | Value |
|---|---|
| SOP ID | SOP-001 |
| Version | 1.0 |
| Status | Active |
| Last Updated | 2026-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 ​
Method A: Windows App Store (Recommended) ​
- Open the Microsoft Store app
- Search for ngrok
- Click Install
- Wait for installation to complete
Method B: Direct Download ​
- Visit download.ngrok.com
- Download the Windows ZIP file for your architecture (64-bit or 32-bit)
- Extract the ZIP to a permanent location, e.g.
C:\ngrok\ - 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
- Press
Verification ​
Open a new terminal (Command Prompt or PowerShell) and run:
bash
ngrok helpYou should see ngrok's help text with available commands.
Verification Checklist ​
- [ ] ngrok is installed
- [ ]
ngrok helpprints help text - [ ] ngrok version is displayed with
ngrok version
System Requirements ​
| Resource | Value |
|---|---|
| Memory | 64MB minimum, 128MB recommended |
| Disk | 25MB |
| CPU | No requirement |
| OS | Windows 64-bit or 32-bit (x86-64, x86) |
Troubleshooting ​
| Issue | Solution |
|---|---|
ngrok not recognized | Ensure the folder is in your PATH and open a new terminal |
| Download blocked by antivirus | Add an exception for the ngrok executable |
| Permission denied | Run terminal as Administrator |