> For the complete documentation index, see [llms.txt](https://docs.snyk.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.snyk.io/developer-tools/snyk-cli/releases-and-channels-for-the-snyk-cli.md). # Releases and channels for the Snyk CLI The Snyk CLI release channels and versioning {% hint style="info" %} **Snyk is rolling out a new navigation.** The steps on this page describe the classic interface. If your view looks different, visit [Navigate the Snyk Web UI](https://docs.snyk.io/navigate-the-snyk-web-ui#where-things-moved) to map these options to the new interface. {% endhint %} ## Releases and channels for the Snyk CLI This page describes Snyk CLI releases and support policy, and also explains how to opt in to different channels and the purpose of each channel. ### Releases Beginning with v.1.1291.0, the Snyk CLI follows the industry standard [Semantic Versioning](https://semver.org/) three-part notation as follows. Given a version number MAJOR.MINOR.PATCH, increment the: 1. MAJOR version when you make \[breaking] changes 2. MINOR version when you add functionality in a backward-compatible manner 3. PATCH version when you make backward-compatible bug fixes Additional labels are added for CLI releases as needed based on the standard. In the Snyk CLI context, Snyk defines a breaking change as a change that could break automated workflows and cause failures in your existing working setup, such as CI/CD integrations. Breaking changes will be indicated by incrementing MAJOR and also mentioned in the release notes. Some examples of breaking changes are the following: * Deprecating or changing output fields, field names, or environment variables * Introducing mandatory configuration changes * Changes in error or exit codes ### Channels Beginning with v.1.1291.0, Snyk is providing different channels to enable customers to opt in to a channel based on their needs and preferences. When you select a channel, you are selecting the stability level you want to use: **preview**, **rc**, or **stable**. #### preview {% hint style="info" %} Snyk offers a preview channel for those who want to test *in-progress* features. However, keep in mind that this channel may contain bugs and is not officially supported. {% endhint %} A preview version is not recommended for production environments. It may contain bugs and is best tested in a local environment. For instructions on installing a preview version, see [Install standalone executables from a channel.](#install-standalone-executables-from-a-channel) * Preview: pre-release builds are deployed regularly up to multiple times a day and contain the latest changes. * Version Pattern: v{MAJOR}.{MINOR}.{PATCH}-preview * Cadence: Varying * Availability: * Linux: * Windows: * MacOS: * Alpine: * MacOS arm64: * Linux arm64: * Alpine arm64: * For FIPS, add `fips` to the base URL, for example, `https://downloads.snyk.io/fips/cli/preview/snyk-linux` * For experimental builds, add `experimental` to the base URL, for example, `https://downloads.snyk.io/experimental/cli/preview/snyk-linux` #### rc * Release candidate: pre-releases are deployed at distinct points in time and contain a version of the CLI that is expected to be promoted to stable after additional testing. * Version Pattern: v{MAJOR}.{MINOR}.{PATCH}-rc * Cadence: every six weeks, ten days before a stable release (hotfix releases possible) * Availability: * Linux: * Windows: * MacOS: * Alpine: * MacOS arm64: * Linux arm64: * Alpine arm64: * For fips, add `fips` to the base URL, for example, `https://downloads.snyk.io/fips/cli/rc/snyk-linux` * For experimental builds, add `experimental` to the base URL, for example, `https://downloads.snyk.io/experimental/cli/rc/snyk-linux` #### stable * Stable: builds are deployed at distinct points in time after additional testing and are considered stable. * Version Pattern: v{MAJOR}.{MINOR}.{PATCH} * Cadence: every six weeks (hotfix releases possible) * Availability: * * Linux: * Windows: * MacOS: * Alpine: * MacOS arm64: * Linux arm64: * Alpine arm64: * For fips, add `fips` to the base URL, for example, `https://downloads.snyk.io/fips/cli/stable/snyk-linux` * For experimental builds, add `experimental` to the base URL, for example, `https://downloads.snyk.io/experimental/cli/stable/snyk-linux` * Installation methods: * [npm](/developer-tools/snyk-cli/install-the-snyk-cli.md#install-the-snyk-cli-with-npm-or-yarn) * [Homebrew](/developer-tools/snyk-cli/install-the-snyk-cli.md#install-with-homebrew-macos-linux) * [Scoop](/developer-tools/snyk-cli/install-the-snyk-cli.md#install-with-scoop-windows) * [Snyk-images](/developer-tools/snyk-cli/install-the-snyk-cli.md#snyk-cli-in-a-docker-image) Snyk recommends opting in to a stable channel for the following reasons: * A stable build is tested extensively over the course of six weeks during which Snyk development teams use the CLI in the SDLC process * Accompanying release notes help you decide which version best suits your needs However, customers who would like to receive code changes as soon as they are merged can opt in to the preview channel. Note that Snyk does not offer support for the preview channel and expects known issues to be present in this channel. {% hint style="info" %} Existing Snyk customers who are opted in to the previously known latest channel will be automatically opted in to the stable channel. Snyk is mirroring the latest channel and the stable channel to avoid disruption to existing customers. However, Snyk encourages you to switch to the new channels as shown above. {% endhint %} #### Linux static builds As of `v1.1305.0`, the Snyk CLI Linux binaries (`snyk-linux`, `snyk-linux-arm64`) are compiled to be self-contained, including all necessary dependencies, so they don't rely on a user's system having those libraries installed. ### Support policy Snyk supports the latest 12 months of CLI versions in the stable channel, ensuring functionality and performance. Older versions are considered End-of-Support (EOS) and will not receive bug fixes or support for troubleshooting. Snyk provides fixes only in new versions and cannot fix older versions. Customers must upgrade to benefit from improvements. This policy fosters innovation while optimizing resources. If you need help, submit a [request](https://support.snyk.io) to Snyk Support. ### Runtime requirements This section specifies the minimum requirements for the latest CLI, covering aspects such as the operating system, dynamically linked libraries, and runtimes. {% hint style="warning" %} Snyk CLI is designed and expected to run on operating system environments that are actively supported by their vendors and have not reached their End of Support (EOS) or End of Life (EOL). Once an operating system environment reaches its end of support, Snyk will cease testing and providing support for Snyk CLI in that specific environment. {% endhint %} | OS\Architecture | amd64 (minimum requirements) | arm64 (minimum requirements) | | --------------- | ------------------------------------------ | ------------------------------------------ | | macOS | 10.13 | 10.13 | | Linux | - | - | | Alpine | musl libc >= 1.1.18 (3.7.3, other distros) | musl libc >= 1.1.18 (3.7.3, other distros) | | Windows | 8.1 | - | ### Install standalone executables from a channel Use the `release.json` in each channel. The download links are provided here, followed by an example for the preview version on the MacOS platform: * * For MacOS, download and run a preview version of the CLI in a temporary folder named `snyk-preview`. To do this, you can run the following set of commands. 
mkdir snyk-preview
cd snyk-preview
curl --compressed https://downloads.snyk.io/cli/preview/snyk-macos -o snyk
chmod +x ./snyk
./snyk -version
### Selecting a channel from the IDE {% hint style="info" %} This functionality is available in the IntelliJ IDE. Snyk is extending this capability to other supported IDEs. {% endhint %} The default channel for all IDEs is the stable channel. To select a channel from the IDE, choose a CLI release channel using the dropdown, as shown in the screenshot that follows. Users can switch between channels, for example, switch to release-candidate (**rc**) to receive a hotfix. However, Snyk also recommends the **stable** channel as the default for IDE users.
Choose a CLI release channel

Choose a CLI release channel

--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.snyk.io/developer-tools/snyk-cli/releases-and-channels-for-the-snyk-cli.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.