Notices: This section not yet converted to new layout. Download stats are rolling back out.

Salt Minion


Package test results are passing.

This package was approved as a trusted package on 8/15/2017.

This package installs a salt minion on your system as a windows service. The Salt minion receives commands from the central Salt master and replies with the results of said commands. It can also be used in standalone mode to apply states to a machine without a master by using C:\salt\salt-call.bat --local state.sls [yoursls] or similar commands with --local.
Note that this package supports two arguments: /master=yoursaltmaster and /minion=yourminionname (note the installer itself uses /minion-name, but parsing dictionary keys with the - is painful).
These arguments can be passed to the package via the --params '/master=yoursaltmaster'. The custom salt master is recommended in most environments, the minion name is optional will default to the hostname if not supplied.

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

C:\> choco install saltminion

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

C:\> choco upgrade saltminion


  • tools\chocolateyBeforeModify.ps1 Show
    # Need to keep a copy of the C:\salt\conf\minion and minion.d files in case the user is upgrading and wants to persist their existing settings.
    $chocoBackup =  '$env:ProgramData\chocolatey\lib-bkp\saltconfig'
    $saltConfig = 'C:\salt\conf\'
    # Items to keep around, 'pki' is "identity", 'minion[_id]' is settings and ID, 'minion.d' is additional settings
    #if (Test-Path $saltConfig ) { copy-item $saltConfig $chocoBackup -recurse }
    # In chocolateyInstall.ps1 will need to look for a previous backup and restore files either before install or after upgrade (only IF the master & minion ID match?)
    # if (Test-Path $chocoBackup) { copy-item $chocoBackup $saltConfig -recurse }
    # Maybe do the backup via another package that simply assumes C:\salt\conf and performs the backup? but reverse-depends don't work here
    # In chocolateyUninstall.ps1 will need to remove $chocoBackup if it exists but only if doing a real uninstall and not an upgrade
  • tools\chocolateyInstall.ps1 Show
    $packageName = 'saltminion'
    # Update these URLs and checksums when deploying a new version
    $url = ''
    $checksum = 'F7A1F4D89926C09ED667B8EE7B453EB3'
    $url64 = ''
    $checksum64 = '99A67B2338A3E00F06519087FBBB3AED'
    # Get arguments to download the file from the URLs and checksums above
    $packageArgs = @{
      packageName   = $packageName
      fileType      = 'exe'
      url           = $url
      url64bit      = $url64
      silentArgs    = "/S"
      softwareName  = 'Salt*'
      checksum      = $checksum
      checksumType  = 'md5'
      checksum64    = $checksum64
      checksumType64= 'md5'
    $arguments = @{};
    # /master=myMaster /minion=myMinion
    $packageParameters = $env:chocolateyPackageParameters;
    # Default the values
    $saltMaster = ''
    $minionName = ''
    # Now parse the packageParameters using good old regular expression
    if ($packageParameters) {
        $match_pattern = "\/(?<option>([a-zA-Z]+))=(?<value>([`"'])?([a-zA-Z0-9- _\\:\.]+)([`"'])?)|\/(?<option>([a-zA-Z]+))"
        $option_name = 'option'
        $value_name = 'value'
        if ($packageParameters -match $match_pattern ){
            $results = $packageParameters | Select-String $match_pattern -AllMatches
            $results.matches | % {
          throw "Package Parameters were found but were invalid (REGEX Failure)"
        if ($arguments.ContainsKey("master")) {
            Write-Host "You specified a custom master address"
            $saltMaster = $arguments['master']
            $packageArgs['silentArgs'] += " /master=$saltMaster"
        if ($arguments.ContainsKey("minion")) {
            Write-Host "You specified a custom minion ID"
            $minionName = $arguments['minion']
            $packageArgs['silentArgs'] += " /minion-name=$minionName"
    } else {
        Write-Debug "No Package Parameters Passed in, using defaults of /master=salt and /minion=$env:COMPUTERNAME"
    install-ChocolateyPackage @packageArgs
  • tools\chocolateyUninstall.ps1 Show
    # By default, salt installs in c:\salt This package will attempt to call the uninstall executable from there. 
    C:\salt\uninst.exe /S

Virus Scan Results

No results available for this package. We are building up results for older packages over time so expect to see results. If this is a new package, it should have results within a day or two.



Software Author(s)

  • SaltStack


Release Notes

  • Supports /master and /minion parameters

    • Updated to latest version

    • Installer waits for the service to finish registering

Version History

Version Downloads Last updated Status
Salt Minion 2017.7.0 281 Wednesday, July 26, 2017 approved
Salt Minion 2016.11.6 660 Wednesday, June 28, 2017 approved
Salt Minion 2016.11.5 590 Friday, May 19, 2017 approved
Salt Minion 2016.11.4 456 Thursday, April 27, 2017 approved
Salt Minion 2016.11.3 412 Wednesday, March 1, 2017 approved
Salt Minion 2016.11.2 314 Tuesday, January 31, 2017 approved
Salt Minion 2016.11.1 39 Sunday, January 29, 2017 approved
Salt Minion 2016.3.4 251 Wednesday, December 21, 2016 approved
Salt Minion 2016.3.3 1157 Wednesday, August 31, 2016 approved
Show More

Discussion for the Salt Minion Package

Ground rules:

  • This discussion is only about Salt Minion and the Salt Minion 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 Salt Minion, 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