Unpacking Software Livestream

Join our monthly Unpacking Software livestream to hear about the latest news, chat and opinion on packaging, software deployment and lifecycle management!

Learn More

Chocolatey Product Spotlight

Join the Chocolatey Team on our regular monthly stream where we put a spotlight on the most recent Chocolatey product releases. You'll have a chance to have your questions answered in a live Ask Me Anything format.

Learn More

Chocolatey Coding Livestream

Join us for the Chocolatey Coding Livestream, where members of our team dive into the heart of open source development by coding live on various Chocolatey projects. Tune in to witness real-time coding, ask questions, and gain insights into the world of package management. Don't miss this opportunity to engage with our team and contribute to the future of Chocolatey!

Learn More

Calling All Chocolatiers! Whipping Up Windows Automation with Chocolatey Central Management

Webinar from
Wednesday, 17 January 2024

We are delighted to announce the release of Chocolatey Central Management v0.12.0, featuring seamless Deployment Plan creation, time-saving duplications, insightful Group Details, an upgraded Dashboard, bug fixes, user interface polishing, and refined documentation. As an added bonus we'll have members of our Solutions Engineering team on-hand to dive into some interesting ways you can leverage the new features available!

Watch On-Demand
Chocolatey Community Coffee Break

Join the Chocolatey Team as we discuss all things Community, what we do, how you can get involved and answer your Chocolatey questions.

Watch The Replays
Chocolatey and Intune Overview

Webinar Replay from
Wednesday, 30 March 2022

At Chocolatey Software we strive for simple, and teaching others. Let us teach you just how simple it could be to keep your 3rd party applications updated across your devices, all with Intune!

Watch On-Demand
Chocolatey For Business. In Azure. In One Click.

Livestream from
Thursday, 9 June 2022

Join James and Josh to show you how you can get the Chocolatey For Business recommended infrastructure and workflow, created, in Azure, in around 20 minutes.

Watch On-Demand
The Future of Chocolatey CLI

Livestream from
Thursday, 04 August 2022

Join Paul and Gary to hear more about the plans for the Chocolatey CLI in the not so distant future. We'll talk about some cool new features, long term asks from Customers and Community and how you can get involved!

Watch On-Demand
Hacktoberfest Tuesdays 2022

Livestreams from
October 2022

For Hacktoberfest, Chocolatey ran a livestream every Tuesday! Re-watch Cory, James, Gary, and Rain as they share knowledge on how to contribute to open-source projects such as Chocolatey CLI.

Watch On-Demand

Downloads:

174,938

Downloads of v 1.25.4:

523

Last Update:

14 Feb 2024

Package Maintainer(s):

Software Author(s):

  • Igor Sysoev

Tags:

webserver proxy caching load-balancing

nginx

  • 1
  • 2
  • 3

1.25.4 | Updated: 14 Feb 2024

Downloads:

174,938

Downloads of v 1.25.4:

523

Maintainer(s):

Software Author(s):

  • Igor Sysoev

nginx 1.25.4

  • 1
  • 2
  • 3

Some Checks Have Failed or Are Not Yet Complete

Not All Tests Have Passed


Validation Testing Passed


Verification Testing Passed

Details

Scan Testing Resulted in Flagged as a Note:

At least one file within this package has greater than 0 detections, but less than 5

Details
Learn More

Deployment Method: Individual Install, Upgrade, & Uninstall

To install nginx, run the following command from the command line or from PowerShell:

>

To upgrade nginx, run the following command from the command line or from PowerShell:

>

To uninstall nginx, run the following command from the command line or from PowerShell:

>

Deployment Method:

NOTE

This applies to both open source and commercial editions of Chocolatey.

1. Enter Your Internal Repository Url

(this should look similar to https://community.chocolatey.org/api/v2/)


2. Setup Your Environment

1. Ensure you are set for organizational deployment

Please see the organizational deployment guide

2. Get the package into your environment

  • Open Source or Commercial:
    • Proxy Repository - Create a proxy nuget repository on Nexus, Artifactory Pro, or a proxy Chocolatey repository on ProGet. Point your upstream to https://community.chocolatey.org/api/v2/. Packages cache on first access automatically. Make sure your choco clients are using your proxy repository as a source and NOT the default community repository. See source command for more information.
    • You can also just download the package and push it to a repository Download

3. Copy Your Script

choco upgrade nginx -y --source="'INTERNAL REPO URL'" [other options]

See options you can pass to upgrade.

See best practices for scripting.

Add this to a PowerShell script or use a Batch script with tools and in places where you are calling directly to Chocolatey. If you are integrating, keep in mind enhanced exit codes.

If you do use a PowerShell script, use the following to ensure bad exit codes are shown as failures:


choco upgrade nginx -y --source="'INTERNAL REPO URL'" 
$exitCode = $LASTEXITCODE

Write-Verbose "Exit code was $exitCode"
$validExitCodes = @(0, 1605, 1614, 1641, 3010)
if ($validExitCodes -contains $exitCode) {
  Exit 0
}

Exit $exitCode

- name: Install nginx
  win_chocolatey:
    name: nginx
    version: '1.25.4'
    source: INTERNAL REPO URL
    state: present

See docs at https://docs.ansible.com/ansible/latest/modules/win_chocolatey_module.html.


chocolatey_package 'nginx' do
  action    :install
  source   'INTERNAL REPO URL'
  version  '1.25.4'
end

See docs at https://docs.chef.io/resource_chocolatey_package.html.


cChocoPackageInstaller nginx
{
    Name     = "nginx"
    Version  = "1.25.4"
    Source   = "INTERNAL REPO URL"
}

Requires cChoco DSC Resource. See docs at https://github.com/chocolatey/cChoco.


package { 'nginx':
  ensure   => '1.25.4',
  provider => 'chocolatey',
  source   => 'INTERNAL REPO URL',
}

Requires Puppet Chocolatey Provider module. See docs at https://forge.puppet.com/puppetlabs/chocolatey.


4. If applicable - Chocolatey configuration/installation

See infrastructure management matrix for Chocolatey configuration elements and examples.

Package Approved

This package was approved as a trusted package on 15 Feb 2024.

Description

nginx [engine x] is an HTTP and reverse proxy server, a mail proxy server, a generic TCP/UDP proxy server, as well as a load balancer and an HTTP cache.

Package Parameters

  • /installLocation - Intstall to a different destination folder. Default: $Env:ChocolateyToolsLocation\Nginx*
  • /serviceName - The name of the windows service which will be create. Default: nginx
  • /port - The port Nginx will listen to. Default: 80
  • /noService - Don't install the nginx windows service
  • /serviceAccount - account to run Windows Service. One of System, LocalService or NetworkService. Default: System

Example: choco install nginx --params '"/installLocation:C:\nginx /port:433"'

Notes

  • This package will install the latest Nginx binaries
  • The complete path of the package will be $Env:ChocolateyToolsLocation\Nginx*
  • Nginx will be installed as a service under the default name 'Nginx' (can be disabled with the /noService install parameter)

Please Note: This is an automatically updated package. If you find it is
out of date by more than a day or two, please contact the maintainer(s) and
let them know the package is no longer updating correctly.


tools\chocolateyBeforeModify.ps1
. (Join-Path (Split-Path -parent $MyInvocation.MyCommand.Definition) 'Helpers.ps1')

Stop-NginxService
tools\helpers.ps1
function Assert-TcpPortIsOpen {
    [CmdletBinding()]
    param(
        [Parameter(Position = 0, Mandatory, ValueFromPipeline)][ValidateNotNullOrEmpty()][int] $portNumber
    )

    $process = Get-NetTCPConnection -State Listen -LocalPort $portNumber -ErrorAction SilentlyContinue | `
        Select-Object -First 1 -ExpandProperty OwningProcess | `
        Select-Object @{Name = "Id"; Expression = {$_} } | `
        Get-Process | `
        Select-Object Name, Path

    if ($process) {
        if ($process.Path) {
            Write-Host "Port '$portNumber' is in use by '$($process.Name)' with path '$($process.Path)'..."
        }
        else {
            Write-Host "Port '$portNumber' is in use by '$($process.Name)'..."
        }

        return $false
    }

    return $true
}

function Get-NginxInstallOptions {
    $toolsDir = Split-Path -parent $MyInvocation.PSScriptRoot
    $configFile = Join-Path $toolsDir 'config.xml'
    $config = Import-CliXml $configFile

    return $config
}

function Get-NginxPaths {
    [CmdletBinding()]
    param(
        [Parameter(Position = 0, Mandatory)][ValidateNotNullOrEmpty()][string] $installDir
    )

    $nginxDir = Get-ChildItem $installDir -Directory -Filter 'nginx*' | Sort-Object { -join $_.Name.Replace('-','.').Split('.').PadLeft(3) } -Descending | Select-Object -First 1 -ExpandProperty FullName
    $confPath = Join-Path $nginxDir 'conf\nginx.conf'
    $binPath = Join-Path $nginxDir 'nginx.exe'

    return @{ NginxDir = $nginxDir; ConfPath = $confPath; BinPath = $binPath }
}

function Install-Nginx {
    [CmdletBinding()]
    param(
        [Parameter(Position = 0, Mandatory)][ValidateNotNullOrEmpty()][PSCustomObject] $arguments
    )

    Get-ChocolateyUnzip `
        -file $arguments.file `
        -destination $arguments.destination

    Set-NginxConfig $arguments

    if ($arguments.serviceName) {
      Install-NginxService $arguments
    }

    Set-NginxInstallOptions $arguments
}

function Install-NginxService {
    [CmdletBinding()]
    param(
        [Parameter(Position = 0, Mandatory)][ValidateNotNullOrEmpty()][PSCustomObject] $arguments
    )

    $nginxPaths = Get-NginxPaths $arguments.destination

    try {
      write-host "Shutting down Nginx if it is running"
      Start-ChocolateyProcessAsAdmin "cmd /c NET STOP $($arguments.serviceName)"
      Start-ChocolateyProcessAsAdmin "cmd /c sc delete $($arguments.serviceName)"
    } catch {
      # no service installed
    }

    nssm stop $($arguments.serviceName) 2>&1 | Out-Null
    nssm remove $($arguments.serviceName) confirm 2>&1 | Out-Null
    nssm install $($arguments.serviceName) "$($nginxPaths.BinPath)" 2>&1 | Out-Null
    nssm set $($arguments.serviceName) Description "Nginx web server" 2>&1 | Out-Null
    nssm set $($arguments.serviceName) AppDirectory  "$($nginxPaths.NginxDir)" 2>&1 | Out-Null
    nssm set $($arguments.serviceName) AppNoConsole 1 2>&1 | Out-Null # Mentioned on top off http://nssm.cc/download
    nssm set $($arguments.serviceName) AppStopMethodSkip 7 2>&1 | Out-Null
    nssm set $($arguments.serviceName) ObjectName "$($arguments.ServiceAccount)" 2>&1 | Out-Null
    nssm start $($arguments.serviceName) 2>&1 | Out-Null
}

function Set-NginxConfig {
    [CmdletBinding()]
    param(
        [Parameter(Position = 0, Mandatory)][ValidateNotNullOrEmpty()][PSCustomObject] $arguments
    )

    $nginxPaths = Get-NginxPaths $arguments.destination

    # Set the server root and port number
    $nginxConf = Get-Content $nginxPaths.ConfPath
    $nginxConf = $nginxConf -replace 'listen\s(.*\d)', "listen       $($arguments.port)"

    Set-Content -Path $nginxPaths.ConfPath -Value $nginxConf -Encoding Ascii
}

function Set-NginxInstallOptions {
    [CmdletBinding()]
    param(
        [Parameter(Position = 0, Mandatory)][ValidateNotNullOrEmpty()][PSCustomObject] $arguments
    )

    $nginxPaths = Get-NginxPaths $arguments.destination

    $config = @{
        Destination = $nginxPaths.NginxDir
        BinPath   = $nginxPaths.BinPath
        ServiceName = $arguments.serviceName
        ServiceAccount = $arguments.ServiceAccount
    }

    $toolsDir = Split-Path -parent $MyInvocation.PSScriptRoot
    $configFile = Join-Path $toolsDir 'config.xml'
    Export-Clixml -Path $configFile -InputObject $config
}

function Stop-NginxService {
    $config = Get-NginxInstallOptions

    $service = Get-Service | Where-Object Name -eq $config.serviceName

    if ($service) {
        Stop-Service $config.serviceName
    }
}

function Uninstall-Nginx {
    $config = Get-NginxInstallOptions

    Uninstall-NginxService

    Remove-Item $config.destination -Recurse -Force
}

function Uninstall-NginxService {
    $config = Get-NginxInstallOptions

    if ($config.serviceName) {
      nssm stop $($config.serviceName) 2>&1 | Out-Null
      nssm remove $($config.serviceName) confirm 2>&1 | Out-Null
    }
}
tools\chocolateyInstall.ps1
$toolsDir = Split-Path -parent $MyInvocation.MyCommand.Definition
. "$toolsDir\helpers.ps1"

$pp = Get-PackageParameters

$arguments = @{
    packageName = $env:chocolateyPackageName
    file        = "$toolsDir\nginx-1.25.4.zip"
    destination = if ($pp.installLocation) { $pp.installLocation } else { Get-ToolsLocation }
    port        = if ($pp.Port) { $pp.Port } else { 80 }
    serviceName = if ($pp.NoService) { $null } elseif ($pp.serviceName) { $pp.serviceName } else { 'nginx' }
    serviceAccount = if ($pp.ServiceAccount) { $pp.ServiceAccount } else { 'SYSTEM' }
}

if (-not (Assert-TcpPortIsOpen $arguments.port)) {
    throw 'Please specify a different port number...'
}

Install-Nginx $arguments
tools\nginx-1.25.4.zip
md5: 0F9B063F7D84F3E2742C442417361E0D | sha1: D88D2A16786093BED2FFFE5F31B1BCA9BD20DC70 | sha256: A4FEA7945477882836B9721FC9F8F861406CEC1850F6DD91F4410BE20BDE47D2 | sha512: EE1F4D57562C00CD5A0D1FC8FC9841EC85503E00417D7C536BA9BE86F5EC82B96CEB1FF596FD73682DC92034CDF8E50A69E8C7F59FD0DC5E6A627D06CA74B6E9
tools\chocolateyUninstall.ps1
$toolsDir = Split-Path -parent $MyInvocation.MyCommand.Definition
. "$toolsDir\helpers.ps1"

Uninstall-Nginx
legal\VERIFICATION.txt
VERIFICATION
Verification is intended to assist the Chocolatey moderators and community
in verifying that this package's contents are trustworthy.

The installer have been downloaded from their official download link listed on <https://nginx.org/en/download.html>
and can be verified like this:

1. Download the following installers:
  32-Bit: <https://nginx.org/download/nginx-1.25.4.zip>
2. You can use one of the following methods to obtain the checksum
  - Use powershell function 'Get-Filehash'
  - Use chocolatey utility 'checksum.exe'

  checksum type: sha256
  checksum32: A4FEA7945477882836B9721FC9F8F861406CEC1850F6DD91F4410BE20BDE47D2

File 'LICENSE.txt' is obtained from <https://nginx.org/LICENSE>
legal\LICENSE.txt
/* 
 * Copyright (C) 2002-2018 Igor Sysoev
 * Copyright (C) 2011-2018 Nginx, Inc.
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 */

Log in or click on link to see number of positives.

In cases where actual malware is found, the packages are subject to removal. Software sometimes has false positives. Moderators do not necessarily validate the safety of the underlying software, only that a package retrieves software from the official distribution point and/or validate embedded software against official distribution point (where distribution rights allow redistribution).

Chocolatey Pro provides runtime protection from possible malware.

Add to Builder Version Downloads Last Updated Status
nginx 1.25.3 8406 Tuesday, October 24, 2023 Approved
nginx 1.25.2 6198 Tuesday, August 15, 2023 Approved
nginx 1.25.1 5391 Tuesday, June 13, 2023 Approved
nginx 1.25.0 2688 Tuesday, May 23, 2023 Approved
nginx 1.23.4 5272 Tuesday, March 28, 2023 Approved
nginx 1.23.3 7683 Tuesday, December 13, 2022 Approved
nginx 1.23.2.20221024 4775 Monday, October 24, 2022 Approved
nginx 1.23.2 2014 Wednesday, October 19, 2022 Approved
nginx 1.23.1 8073 Tuesday, July 19, 2022 Approved
nginx 1.23.0 2338 Tuesday, June 21, 2022 Approved
nginx 1.21.6 11467 Tuesday, January 25, 2022 Approved
nginx 1.21.5 3209 Tuesday, December 28, 2021 Approved
nginx 1.21.4 6004 Tuesday, November 2, 2021 Approved
nginx 1.21.3 3146 Tuesday, September 7, 2021 Approved
nginx 1.21.2 556 Tuesday, August 31, 2021 Approved
nginx 1.21.1 3093 Tuesday, July 6, 2021 Approved
nginx 1.21.0 2236 Tuesday, May 25, 2021 Approved
nginx 1.19.10 1983 Tuesday, April 13, 2021 Approved
nginx 1.19.9 671 Tuesday, March 30, 2021 Approved
nginx 1.19.8 1214 Tuesday, March 9, 2021 Approved
nginx 1.19.7 1892 Tuesday, February 16, 2021 Approved
nginx 1.19.6 1786 Tuesday, December 15, 2020 Approved
nginx 1.19.5 1006 Tuesday, November 24, 2020 Approved
nginx 1.19.4 1024 Tuesday, October 27, 2020 Approved
nginx 1.19.3 1486 Tuesday, September 29, 2020 Approved
nginx 1.19.2 1917 Tuesday, August 11, 2020 Approved
nginx 1.19.1 4534 Tuesday, July 7, 2020 Approved
nginx 1.19.0 6225 Tuesday, May 26, 2020 Approved
nginx 1.17.10 2034 Tuesday, April 14, 2020 Approved
nginx 1.17.9 1515 Tuesday, March 3, 2020 Approved
nginx 1.17.8 5942 Tuesday, January 21, 2020 Approved
nginx 1.17.7 3713 Tuesday, December 24, 2019 Approved
nginx 1.17.6 3994 Tuesday, November 19, 2019 Approved
nginx 1.17.5 1753 Tuesday, October 22, 2019 Approved
nginx 1.17.4 2646 Tuesday, September 24, 2019 Approved
nginx 1.17.3 3691 Tuesday, August 13, 2019 Approved
nginx 1.17.2 1660 Tuesday, July 23, 2019 Approved
nginx 1.17.1 2332 Tuesday, June 25, 2019 Approved
nginx 1.17.0 2963 Tuesday, May 21, 2019 Approved
nginx 1.15.12 2833 Tuesday, April 16, 2019 Approved
nginx 1.15.11 498 Tuesday, April 9, 2019 Approved
nginx 1.15.10 618 Tuesday, March 26, 2019 Approved
nginx 1.15.9.20190310 597 Sunday, March 10, 2019 Approved
nginx 1.15.9 627 Tuesday, February 26, 2019 Approved
nginx 1.15.8 8893 Monday, January 7, 2019 Approved
nginx 1.14.1 1324 Wednesday, November 21, 2018 Approved
nginx 1.12.2 5527 Tuesday, December 19, 2017 Approved
nginx 1.12.1 1905 Tuesday, July 18, 2017 Approved
nginx 1.12.0 1314 Wednesday, April 12, 2017 Approved
nginx 1.10.3 1398 Tuesday, January 31, 2017 Approved
nginx 1.10.2 2449 Thursday, October 20, 2016 Approved
nginx 1.10.1 1134 Wednesday, June 1, 2016 Approved
nginx 1.8.0 895 Friday, October 2, 2015 Approved
nginx 1.6.2 3580 Tuesday, November 25, 2014 Approved
nginx 1.4.1.20130523 1133 Thursday, May 23, 2013 Approved
nginx 1.3.12.20130213 549 Wednesday, February 13, 2013 Approved
nginx 1.2.7.20130212 487 Tuesday, February 12, 2013 Approved

Discussion for the nginx Package

Ground Rules:

  • This discussion is only about nginx and the nginx package. If you have feedback for Chocolatey, please contact the Google Group.
  • This discussion will carry over multiple versions. If you have a comment about a particular version, please note that in your comments.
  • The maintainers of this Chocolatey Package will be notified about new comments that are posted to this Disqus thread, however, it is NOT a guarantee that you will get a response. If you do not hear back from the maintainers after posting a message below, please follow up by using the link on the left side of this page or follow this link to contact maintainers. If you still hear nothing back, please follow the package triage process.
  • Tell us what you love about the package or nginx, or tell us what needs improvement.
  • Share your experiences with the package, or extra configuration or gotchas that you've found.
  • If you use a url, the comment will be flagged for moderation until you've been whitelisted. Disqus moderated comments are approved on a weekly schedule if not sooner. It could take between 1-5 days for your comment to show up.
comments powered by Disqus