# Releases

Coder releases are cut directly from main in our
[GitHub](https://github.com/coder/coder) on the first Tuesday of each month.

We recommend enterprise customers test the compatibility of new releases with
their infrastructure on a staging environment before upgrading a production
deployment.

We support two release channels:
[mainline](https://github.com/coder/coder/releases/tag/v2.16.0) for the bleeding
edge version of Coder and
[stable](https://github.com/coder/coder/releases/latest) for those with lower
tolerance for fault. We field our mainline releases publicly for one month
before promoting them to stable. The version prior to stable receives patches
only for security issues or CVEs.

### Mainline releases

* Intended for customers with a staging environment
* Gives earliest access to new features
* May include minor bugs
* All bugfixes and security patches are supported

### Stable releases

* Safest upgrade/installation path
* May not include the latest features
* All bugfixes and security patches are supported

### Security Support

* In-product security vulnerabilities and CVEs are supported

> For more information on feature rollout, see our
> [feature stages documentation](/docs/@v2.17.3/contributing/feature-stages/).

## Installing stable

When installing Coder, we generally advise specifying the desired version from
our GitHub [releases page](https://github.com/coder/coder/releases).

You can also use our `install.sh` script with the `stable` flag to install the
latest stable release:

```shell
curl -fsSL https://coder.com/install.sh | sh -s -- --stable
```

Best practices for installing Coder can be found on our [install](/docs/@v2.17.3/install/)
pages.

## Release schedule

| Release name | Release Date       | Status           |
| ------------ | ------------------ | ---------------- |
| 2.9.x        | March 07, 2024     | Not Supported    |
| 2.10.x       | April 03, 2024     | Not Supported    |
| 2.11.x       | May 07, 2024       | Not Supported    |
| 2.12.x       | June 04, 2024      | Not Supported    |
| 2.13.x       | July 02, 2024      | Not Supported    |
| 2.14.x       | August 06, 2024    | Security Support |
| 2.15.x       | September 03, 2024 | Stable           |
| 2.16.x       | October 01, 2024   | Mainline         |
| 2.17.x       | November 05, 2024  | Not Released     |

> **Tip**: We publish a
> [`preview`](https://github.com/coder/coder/pkgs/container/coder-preview) image
> `ghcr.io/coder/coder-preview` on each commit to the `main` branch. This can be
> used to test under-development features and bug fixes that have not yet been
> released to [`mainline`](#mainline-releases) or [`stable`](#stable-releases).
>
> > **Important**: The `preview` image is not intended for production use.
