Skip to main content
This document applies to the following products:
  • ngrok Agent

​
Versioning

ngrok follows Semantic Versioning, and limits breaking changes to major upgrades.

​
Cadence

Typical minor releases happen at least quarterly while typical patch releases are at least monthly. Critical bug fixes may cause a more immediate release outside of the normal cadence. ngrok also aims not to make releases during major US holiday periods.

​
Support period

In accordance with the release cadence, ngrok supports a minor release for 14 months. Support includes:
  • Patches
  • Critical security fixes
Toward the end of the 14-month support period, the following happens:
  • The two-month upgrade cycle begins. During the last two months of a support period, the following applies:
    • No more patches or critical security fixes occur.
    • ngrok attempts to notify users through the following channels:
      • Via email
      • Via social media
      • Status Page
      • Documentation Page
      • That release’s agent banner
After the two-month upgrade cycle has ended, the following happens:
  • The Agent version enters end-of-life.
    • On the free plan, ngrok raises the minimum agent version on or after the end-of-life date. From then on, an agent on an end-of-life version can no longer connect to ngrok’s cloud network: a new session fails with ERR_NGROK_121 and the agent exits at startup. An agent that is already connected stays up until it reconnects, then keeps retrying and logging the error while its endpoints stay offline. See Deprecation Notices if you received the email.
    • On a paid plan, the agent still connects and shows a generic deprecation warning.

​
Extended support

Extended support beyond the 14-month support period is available to customers on a commercial basis. It includes critical security fixes only. Contact Support for additional details.

​
Release support chart

Dates are computed from the first release of each minor version; later patches do not extend them. Active Support is the last date a release receives patches.