Skip to main content
ngrok periodically retires older agent versions to maintain the security, performance, and reliability of the service. When a version approaches end-of-life, free-tier users running that version receive an email notice with a deadline to act.

Why did I receive this email?

You received this notice because an ngrok agent running a version at or below the deprecated threshold connected to your account within the last 90 days. This is a heads-up: your service has not been interrupted yet. You have until the deadline in the email to take action.

What happens if I don’t act?

After the deprecation date, agents running the affected version will fail to connect to the ngrok cloud service. Any endpoints they serve will become unavailable and return an error. No further warning will be issued.

What are my options?

Option 1: Update your agent (free)

Updating to a supported version is free and takes only a few minutes. Update in place using the CLI:
ngrok update
Or download the latest version manually from the ngrok downloads page. Once updated, verify your version:
ngrok version
See the Version Support Policy for release and end-of-life dates.

Option 2: Upgrade to a paid plan

Paid accounts are not subject to agent version deprecations. If staying on an older agent version is a requirement for your environment, upgrading is a valid alternative.
This exemption applies as long as your account remains on a paid plan. Downgrading back to a free plan will re-apply deprecation enforcement.
Choose a plan →

How do I check which version I’m running?

Run the following command on each machine where the ngrok agent is installed:
ngrok version
Example output:
ngrok version 3.19.1
Cross-reference your version against the Release Support Chart to confirm whether it is still within its active support window.

Frequently asked questions

Yes. Once you update to a supported version, your account will no longer trigger notices for that deprecation campaign. If you recently updated, allow a short period for the system to reflect the change before expecting emails to stop.
No. Deprecation enforcement applies to free-tier accounts only. Paying customers can continue using older agent versions without interruption.
Only agents running a deprecated version need to be updated. You can update agents remotely from the ngrok dashboard, or update each affected machine individually by running ngrok update or replacing the binary manually.
Only if you plan to upgrade to a paid plan, or if you no longer actively use the agent on that account. Otherwise, your tunnels will stop working after the deadline.
Deprecations follow the ngrok Agent Version Support Policy. Retiring older versions allows ngrok to focus on new features and improvements to the security, performance, and reliability of the service without maintaining compatibility with legacy agent behavior indefinitely.

Still need help?

Reach out to support@ngrok.com with any questions.