ngrok
ngrok, Inc. · Expose local and private services through secure public endpoints, with traffic policies, inspection, and request replay for development and connectivity.
brew install --cask ngrok- 30-day installs
- 13,191
- #33 in App
- 1-year installs
- 366.7K
- Last 365 days
- Latest version
- 3.39.13
- Download size
- 11MB
- zip
- Release cadence
- Every 2 weeks
- 1 release in 30 days
About
ngrok is a command-line agent that connects a local or private service to ngrok's cloud over an outbound TLS connection. You add an authtoken, start a tunnel to a local port, and use the public HTTPS endpoint the agent prints. This page records version 3.39.13,msmi2kd3cjc,a. The public endpoint stays up only while that agent process is running. The Free plan lists a one-time $5 usage credit.
What it is for
Developers use the agent for app previews, webhook testing, and API work when the origin has no public IP and inbound firewall changes are not available. HTTP and HTTPS tunnels forward to a local port. TCP and TLS endpoints exist for supported non-HTTP cases, subject to the account. Traffic Policy can authenticate, route, rewrite, or rate-limit requests before they reach the upstream. The agent can inspect HTTP traffic and replay a captured request. Related network tools are in the Networking category.
Install on Mac and add an authtoken
Install the Homebrew cask with brew install --cask ngrok. The package installs the ngrok executable and shell completions, not a graphical Mac application. Create an ngrok account, copy the agent authtoken, and run ngrok config add-authtoken <YOUR_AUTHTOKEN>. That command writes the authtoken into the local configuration file. The dashboard shows a new token only once. Start the local app, then run ngrok http 8080, replacing 8080 with its listening port. Use the endpoint the agent prints. That endpoint exists while the agent session runs. A Cloud Endpoint is a separate object with a different lifecycle. Setup notes for similar remote-access cases are in the Remote access by need collection.
System requirements
ngrok's install documentation says the standalone agent has no external runtime dependency and documents 64 MB minimum memory, 128 MB recommended, and about 25 MB of disk. Those figures are runtime guidance, not the compressed download size. Usage grows with concurrent traffic. The upstream app must be running and reachable from the agent. Cloud endpoints need outbound TLS to ngrok, typically on port 443. A corporate proxy, firewall, or account control can block that path. Official agent builds exist for macOS x86-64 and arm64, plus Windows, Linux, and FreeBSD. The Homebrew snapshot used here does not state a numeric macOS minimum, so this page does not invent one. Network symptoms are collected in the Mac network diagnosis collection.
Price and licence
ngrok's pricing page, checked on 2026-11-08, lists Free at $0 with a one-time $5 usage credit and no usage beyond that credit. It lists up to 3 online endpoints, up to 1 GB of data transfer, up to 20,000 HTTP/S requests, an interstitial page on HTTP/S endpoints, an assigned dev domain, and 1 team member. Hobbyist is listed at $10 monthly, with $10 of monthly included usage and no usage beyond that credit, up to 3 online endpoints, 5 GB of data transfer included, 100,000 HTTP/S requests included, no interstitial page, and ngrok-branded domains. Pay-as-you-go is listed at $20 monthly plus additional usage, with $20 of monthly included usage, unlimited online endpoints, and extra usage billed monthly. Enterprise is custom, with SSO/SAML, SCIM, contracts, and a SOC 2 mention on that page. Plan names and limits change. Confirm https://ngrok.com/pricing before you rely on a quota. The current agent and cloud service follow ngrok's Terms of Service. This distributed agent is not the old open-source ngrok v1 project.
Versions
The recorded catalog version is 3.39.13,msmi2kd3cjc,a. Update a Homebrew install with brew upgrade --cask ngrok. Read the current install page before you treat a flag as available.
Access control and related tools
Traffic Policy can require a sign-in before a request reaches the local app. ngrok's authentication guide shows an OAuth action, including a Google provider example, and a deny rule that checks the signed-in email domain. The network-security guide shows an IP allow list with restrict-ips, and mutual TLS so only a client with a valid certificate connects. Authtoken ACLs limit which actions that one agent credential may take. An authtoken with no ACL may take every action the account allows. Tailscale keeps a persistent private network among signed-in devices and does not publish those devices to the public internet by default. Cloudflare Tunnel is Cloudflare's connector for reaching a private origin through Cloudflare's network without opening an inbound port. It uses a Cloudflare account and its own configuration. OpenNavo has no Cloudflare Tunnel app page, so this page does not link one. ZeroTier is a separate virtual-network client, not an ngrok tunnel. Choose the tool that matches a temporary public endpoint or a standing private network, and check each product's own account and pricing.
FAQ
How do I add the authtoken?
Create an ngrok account, copy the authtoken, and run ngrok config add-authtoken <YOUR_AUTHTOKEN> before you start a tunnel. A newly created token is shown once.
What does the Free plan include?
The pricing page lists a one-time $5 usage credit, up to 3 online endpoints, up to 1 GB of data transfer, up to 20,000 HTTP/S requests, and an interstitial page on HTTP/S endpoints. It does not add usage beyond that credit.
Why does the tunnel stop or fail to start?
An agent endpoint exists while that agent session runs. Stopping the process ends the endpoint. A Cloud Endpoint is a different object. A missing or expired authtoken, a plan limit, or blocked outbound TLS also stops traffic. The install page says you can lower memory use by turning inspection off in the configuration file.
How is this different from Tailscale and Cloudflare Tunnel?
ngrok publishes an endpoint for a local port, aimed at previews, webhooks, and demos. Tailscale connects signed-in devices on a private network and does not publish them to the public internet by default. Cloudflare Tunnel reaches a private origin through Cloudflare without an inbound port, under a Cloudflare account.
Last updated: 2026-11-08. Sources: ngrok pricing (https://ngrok.com/pricing), agent install (https://ngrok.com/docs/gateway/agent/install), agent authtokens (https://ngrok.com/docs/gateway/agent/authtokens), authentication (https://ngrok.com/docs/share-localhost/auth), network security (https://ngrok.com/docs/share-localhost/security), and terms (https://ngrok.com/tos). Recorded version 3.39.13,msmi2kd3cjc,a.
At a glance
- Price
- Free with in-app purchases
- Chip
- Apple silicon
- Auto-updates
- No
- Developer
- ngrok, Inc.
- Homebrew
- Available; updated by Homebrew
- Homepage
- ngrok.com
- Token
- ngrok
Checked
What’s new in 3.39.13 (a)
New · OpenNavo editorial
ngrok 3.39.13(2026-10-22)将 golang.org/x/net 更新至 v0.60.0,修补安全漏洞。
How to install ngrok on Mac
Install without Homebrew
Download the same file Homebrew uses: Install Details
Uninstall ngrok and optional data cleanup
brew uninstall --cask ngrokA regular uninstall removes the app and keeps its settings and caches.
Deep clean (optional)
brew uninstall --zap --cask ngrok--zap also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out --zap.
Questions about ngrok
Is ngrok safe?
ngrok is in Homebrew’s official catalog and has not been disabled. Since September 2026, Homebrew disables apps that fail macOS Gatekeeper checks. When installing, Homebrew checks the download from bin.ngrok.com against its SHA-256 checksum. It was installed 13,191 times through Homebrew in the last 30 days.
Is ngrok free?
ngrok is free to download and offers in-app purchases. Source: ngrok.com/pricing, checked Oct 22, 2026.
How do I completely uninstall ngrok on a Mac?
Run brew uninstall --cask ngrok. To delete its settings and caches as well, run brew uninstall --zap --cask ngrok. --zap also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out --zap. That also deletes 2 files and folders, including ~/.
Where does ngrok store its settings and data?
Its data is in ~/ and ~/. These locations come from Homebrew’s clean-up list.
What is the latest version of ngrok?
The latest version is 3.39.13. Run brew upgrade --cask ngrok to update it.
What else does installing ngrok add?
It also adds 1 command-line tool: ngrok.
Similar Apps
- TailscaleConnect Macs, servers, and other devices through a WireGuard-based private network with device discovery, access policies, subnet routes, and exit nodes.
- mitmproxyFree, open-source proxy for inspecting, modifying, recording and replaying HTTP/S traffic, with terminal, scripted and browser-based interfaces.
- WiresharkInspect network packets, capture traffic and analyze protocols with filters, statistics and companion command-line tools.
- Windows AppMicrosoft remote-access client for Windows PCs, cloud desktops and administrator-provided Windows applications.