Skip to content

Commit

Permalink
Add support lifecycle, update Choco requirements
Browse files Browse the repository at this point in the history
  • Loading branch information
vexx32 committed Apr 24, 2023
1 parent 0e1d732 commit a17b4f8
Show file tree
Hide file tree
Showing 3 changed files with 80 additions and 12 deletions.
29 changes: 19 additions & 10 deletions input/en-us/choco/setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,29 +2,38 @@
Order: 20
xref: setup-choco
Title: Setup / Install
Description: Techniques for how to install Chocolatey
Description: How to install Chocolatey CLI
RedirectFrom:
- docs/installation
- docs/install
---

## Requirements

* Windows 7+ / Windows Server 2003+
* PowerShell v2+ (Not PowerShell Core yet though)(minimum is v3 for install from this website due to [TLS 1.2 requirement](https://blog.chocolatey.org/2020/01/remove-support-for-old-tls-versions/))
* .NET Framework 4+ (the installation will attempt to install .NET 4.0 if you do not have it installed)(minimum is 4.5 for install from this website due to [TLS 1.2 requirement](https://blog.chocolatey.org/2020/01/remove-support-for-old-tls-versions/))
- [A supported version of Windows](xref:support-lifecycle#supported-windows-versions)
- Windows PowerShell v2.0 or higher
- Windows PowerShell v3 is required for directly installing Chocolatey from the Community Repository due to the [TLS 1.2 requirement](https://blog.chocolatey.org/2020/01/remove-support-for-old-tls-versions/)

That's it! All you need is choco.exe (that you get from the installation scripts) and you are good to go! No Visual Studio required.
### Chocolatey CLI v2.0+

## Installing Chocolatey
- .NET Framework 4.8
- The installation script will attempt to install .NET 4.8 if it is not installed.

Chocolatey installs in seconds. You are just a few steps from running choco right now!
### Chocolatey CLI v1.x

1. First, ensure that you are using an **[administrative shell](http://www.howtogeek.com/194041/how-to-open-the-command-prompt-as-administrator-in-windows-8.1/)** - you can also install as a non-admin, check out <a href="#non-administrative-install">Non-Administrative Installation</a>.
- .NET Framework 4+
- The installation will attempt to install .NET 4.0 if you do not have it installed
- .NET Framework 4.5+ is required for installing directly from the Community Repository, due to the [TLS 1.2 requirement](https://blog.chocolatey.org/2020/01/remove-support-for-old-tls-versions/)

## Installing Chocolatey CLI

1. First, ensure that you are using an **[administrative shell](http://www.howtogeek.com/194041/how-to-open-the-command-prompt-as-administrator-in-windows-8.1/)**.
- Refer to [Non-Administrative Installation](#non-administrative-install) for information on installing without administrative rights.
1. Copy the text specific to your command shell - [cmd.exe](#install-with-cmd.exe) or [powershell.exe](#install-with-powershell.exe).
1. Paste the copied text into your shell and press Enter.
1. Wait a few seconds for the command to complete.
1. If you don't see any errors, you are ready to use Chocolatey! Type `choco` or `choco -?` now, or see [Getting Started](xref:getting-started) for usage instructions.
1. If you don't see any errors, you are ready to use Chocolatey CLI!
1. Type `choco` or `choco -?` now, or see [Getting Started](xref:getting-started) for usage instructions.

> :choco-info: **NOTE**
> * If you are behind a proxy, please see <a href="#installing-behind-a-proxy">Installing behind a proxy</a>.
Expand Down Expand Up @@ -74,7 +83,7 @@ The load by default is really hard to see, so you should check to ensure it is t

## More Install Options

<p><strong>Troubleshooting? Proxy? Need more options?</strong></p>
**Troubleshooting? Proxy? Need more options?**

<button class="btn btn-success btn-collapse collapsed" type="button" data-bs-toggle="collapse" data-bs-target="#moreInstallOptions" aria-expanded="false" aria-controls="moreInstallOptions">More Install Options</button>

Expand Down
52 changes: 52 additions & 0 deletions input/en-us/information/support-lifecycle.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
---
Order: 15
xref: support-lifecycle
Title: Product Support Lifecycle and Supported Operating Systems
Description: Information about which versions of Chocolatey products are supported, and the operating systems they're supported on.
---

## Product Support Lifecycle

All of the latest released stable versions of Chocolatey products are fully supported and will periodically receive new features, bug fixes, and security fixes as appropriate.
We recommend customers update to the latest versions to benefit from new features and fixes as they are released.

### Pre-v1.0 Products

For any products that have not yet reached v1.0, **only the latest version is supported**.
We will continue to add features, fix bugs, and address security concerns as normal while we work towards a v1.0 release.

### Version 1.0+ Products

Once a product reaches v1.0, we recommend customers move to that version as soon as possible.
We will not continue to support v0.x versions once a product reaches v1.0.

### Version 2.0+ Products

Once a product reaches the second major release, the following will apply:

1. We will support the previous major version with **security fixes** for licensed customers.
- For example: at v2.0, v1.x versions of the product will receive security fixes; at v3.0, only v2.0x versions of the product will continue to receive security fixes.
1. We will support the previous major version for bug fixes for licensed customers for 6 months following the release of the next major version.
1. No new features will be backported to the previous major version.

## Supported Windows Versions

Chocolatey products' support for Windows operating systems follows Microsoft's support lifecycle: if the Windows version is supported by Microsoft, Chocolatey products are supported on that version of Windows.

This information is up to date as of April 2023.

### Clients

- Windows 11
- Windows 10 22H2
- Windows 10 21H2
- Windows 10 20H2 (Enterprise and Education editions **only**)

### Servers

- Windows Server 2022
- Windows Server 2019
- Windows Server 2016
- Windows Server 2012 R2
- Windows Server 2012
- Windows Server 2008 R2 (in Azure only)
11 changes: 9 additions & 2 deletions input/en-us/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,9 +22,16 @@ Also consider the [frequently asked questions](xref:faqs).

### The request was aborted: Could not create SSL/TLS secure channel

If you see the following: Exception calling "DownloadString" with "1" argument(s): "The request was aborted: Could not create SSL/TLS secure channel." then you are likely running an older machine that needs to be upgraded to be able to use TLS 1.2 at a minimum.
If you see the following error:

community.chocolatey.org now requires TLS 1.2 at a minimum. Please see https://blog.chocolatey.org/2020/01/remove-support-for-old-tls-versions/. The post provides options if you have older clients that need to install Chocolatey.
```sh
Exception calling "DownloadString" with "1" argument(s): "The request was aborted: Could not create SSL/TLS secure channel."
```

The [Chocolatey Community Repository](https://community.chocolatey.org) now requires TLS 1.2 as a minimum, as mentioned in [this blog post](https://blog.chocolatey.org/2020/01/remove-support-for-old-tls-versions/).

If you see this error when attempting to download Chocolatey or any other packages from the Community Repository, you are likely running an older operating system that needs to be upgraded to be able to use TLS 1.2 at a minimum.
See the [Microsoft documentation on enabling TLS 1.2 on older operating systems](https://learn.microsoft.com/en-us/mem/configmgr/core/plan-design/security/enable-tls-1-2-client#bkmk_winhttp).

### The underlying connection was closed

Expand Down

0 comments on commit a17b4f8

Please sign in to comment.