Salt已经充分支持在Windows上运行Salt Minion

目前没有计划在Windows上开发Salt Master。所以目前你必须在一个支持的操作系统上运行Salt Master去控制Windows上的Salt Minions。

许多标准的Salt模块已经移植到了Windows,并且多数Salt States一般也可以在Windows上运行。


Salt Minion Windows安装包可以在这里找到。输出的 md5sum <salt minion exe> 应该匹配一致的md5文件。

Latest stable build from the selected branch:

x86: Salt-Minion-2015.8.7-x86-Setup.exe | md5

AMD64: Salt-Minion-2015.8.7-AMD64-Setup.exe | md5

Earlier builds from supported branches

Archived builds from unsupported branches


The installation executable installs dependencies that the Salt minion requires.

64bit安装包已经在Windows 7 64bit和Windows Server 2008R2 64bit测试通过。32bit安装包已经在Windows 2003 Server 32bit测试通过。如果发现其他平台有问题的话请在我们的GitHub上提交bug。

安装包需要2个信息; master主机名和minion名。安装程序将会用这些选项更新minion配置然后启动minion。

salt-minion 服务将会出现在Windows服务管理器中,可以在那里启动和停止,或者使用命令行程序 sc ,就像其他Windows服务一样。

如果minion没能启动,尝试安装Microsoft Visual C++ 2008 x64 SP1 redistributable。开启所有的Windows updates使salt-minion更加顺利的运行。

Silent Installer Options

The installer can be run silently by providing the /S option at the command line. The installer also accepts the following options for configuring the Salt Minion silently:

  • /master= A string value to set the IP address or host name of the master. Default value is 'salt'
  • /minion-name= A string value to set the minion name. Default is 'hostname'
  • /start-service= Either a 1 or 0. '1' will start the service, '0' will not. Default is to start the service after installation.

Here's an example of using the silent installer:

Salt-Minion-2015.5.6-Setup-amd64.exe /S /master=yoursaltmaster /minion-name=yourminionname /start-service=0

Running the Salt Minion on Windows as an Unprivileged User

Notes: - These instructions were tested with Windows Server 2008 R2 - They are generalizable to any version of Windows that supports a salt-minion

A. Create the Unprivileged User that the Salt Minion will Run As

  1. Click Start > Control Panel > User Accounts.
  2. Click Add or remove user accounts.
  3. Click Create new account.
  4. Enter salt-user (or a name of your preference) in the New account name field.
  5. Select the Standard user radio button.
  6. Click the Create Account button.
  7. Click on the newly created user account.
  8. Click the Create a password link.
  9. In the New password and Confirm new password fields, provide a password (e.g "SuperSecretMinionPassword4Me!").
  10. In the Type a password hint field, provide appropriate text (e.g. "My Salt Password").
  11. Click the Create password button.
  12. Close the Change an Account window.

B. Add the New User to the Access Control List for the Salt Folder

  1. In a File Explorer window, browse to the path where Salt is installed (the default path is C:\Salt).
  2. Right-click on the Salt folder and select Properties.
  3. Click on the Security tab.
  4. Click the Edit button.
  5. Click the Add button.
  6. Type the name of your designated Salt user and click the OK button.
  7. Check the box to Allow the Modify permission.
  8. Click the OK button.
  9. Click the OK button to close the Salt Properties window.

C. Update the Windows Service User for the salt-minion Service

  1. Click Start > Administrative Tools > Services.
  2. In the Services list, right-click on salt-minion and select Properties.
  3. Click the Log On tab.
  4. Click the This account radio button.
  5. Provide the account credentials created in section A.
  6. Click the OK button.
  7. Click the OK button to the prompt confirming that the user has been granted the Log On As A Service right.
  8. Click the OK button to the prompt confirming that The new logon name will not take effect until you stop and restart the service.
  9. Right-Click on salt-minion and select Stop.
  10. Right-Click on salt-minion and select Start.


This document will explain how to set up a development environment for salt on Windows. The development environment allows you to work with the source code to customize or fix bugs. It will also allow you to build your own installation.

The Easy Way

Prerequisite Software

To do this the easy way you only need to install Git for Windows.

Create the Build Environment

  1. Clone the Salt-Windows-Dev repo from github.

    Open a command line and type:

    git clone
  2. Build the Python Environment

    Go into the salt-windows-dev directory. Right-click the file named dev_env.ps1 and select Run with PowerShell

    If you get an error, you may need to change the execution policy.

    Open a powershell window and type the following:

    Set-ExecutionPolicy RemoteSigned

    This will download and install Python with all the dependencies needed to develop and build salt.

  3. Build the Salt Environment

    Right-click on the file named dev_env_salt.ps1 and select Run with Powershell

    This will clone salt into C:\Salt-Dev\salt and set it to the 2015.5 branch. You could optionally run the command from a powershell window with a -Version switch to pull a different version. For example:

    dev_env_salt.ps1 -Version '2014.7'

    To view a list of available branches and tags, open a command prompt in your C:Salt-Devsalt directory and type:

    git branch -a
    git tag -n

The Hard Way

Prerequisite Software

Install the following software:

  1. Git for Windows
  2. Nullsoft Installer

Download the Prerequisite zip file for your CPU architecture from the SaltStack download site:

These files contain all software required to build and develop salt. Unzip the contents of the file to C:\Salt-Dev\temp.

Create the Build Environment

  1. Build the Python Environment

    • Install Python:

      Browse to the C:\Salt-Dev\temp directory and find the Python installation file for your CPU Architecture under the corresponding subfolder. Double-click the file to install python.

      Make sure the following are in your PATH environment variable:

    • 安装Pip

      Open a command prompt and navigate to C:\Salt-Dev\temp Run the following command:

    • Easy Install compiled binaries.

      M2Crypto, PyCrypto, and PyWin32 need to be installed using Easy Install. Open a command prompt and navigate to C:\Salt-Dev\temp\<cpuarch>. Run the following commands:

      easy_install -Z <M2Crypto file name>
      easy_install -Z <PyCrypto file name>
      easy_install -Z <PyWin32 file name>


      You can type the first part of the file name and then press the tab key to auto-complete the name of the file.

    • Pip Install Additional Prerequisites

      All remaining prerequisites need to be pip installed. These prerequisites are as follow:

      • MarkupSafe
      • Jinja
      • MsgPack
      • PSUtil
      • PyYAML
      • PyZMQ
      • WMI
      • Requests
      • Certifi

      Open a command prompt and navigate to C:\Salt-Dev\temp. Run the following commands:

      pip install <cpuarch>\<MarkupSafe file name>
      pip install <Jinja file name>
      pip install <cpuarch>\<MsgPack file name>
      pip install <cpuarch>\<psutil file name>
      pip install <cpuarch>\<PyYAML file name>
      pip install <cpuarch>\<pyzmq file name>
      pip install <WMI file name>
      pip install <requests file name>
      pip install <certifi file name>
  2. Build the Salt Environment

    • Clone Salt

      Open a command prompt and navigate to C:\Salt-Dev. Run the following command to clone salt:

      git clone
    • Checkout Branch

      Checkout the branch or tag of salt you want to work on or build. Open a command prompt and navigate to C:\Salt-Dev\salt. Get a list of available tags and branches by running the following commands:

      git fetch --all
      To view a list of available branches:
      git branch -a
      To view a list of availabel tags:
      git tag -n

      Checkout the branch or tag by typing the following command:

      git checkout <branch/tag name>
    • Clean the Environment

      When switching between branches residual files can be left behind that will interfere with the functionality of salt. Therefore, after you check out the branch you want to work on, type the following commands to clean the salt environment:

Developing with Salt

There are two ways to develop with salt. You can run salt's each time you make a change to source code or you can use the setup tools develop mode.

Configure the Minion

Both methods require that the minion configuration be in the C:\salt directory. Copy the conf and var directories from C:\Salt-Dev\salt\pkg\ windows\buildenv to C:\salt. Now go into the C:\salt\conf directory and edit the file name minion (no extension). You need to configure the master and id parameters in this file. Edit the following lines:

master: <ip or name of your master>
id: <name of your minion> Method

Go into the C:\Salt-Dev\salt directory from a cmd prompt and type:

python install --force

This will install python into your python installation at C:\Python27. Everytime you make an edit to your source code, you'll have to stop the minion, run the setup, and start the minion.

To start the salt-minion go into C:\Python27\Scripts from a cmd prompt and type:


For debug mode type:

salt-minion -l debug

To stop the minion press Ctrl+C.

Setup Tools Develop Mode (Preferred Method)

To use the Setup Tools Develop Mode go into C:\Salt-Dev\salt from a cmd prompt and type:

pip install -e .

This will install pointers to your source code that resides at C:\Salt-Dev\salt. When you edit your source code you only have to restart the minion.

Build the windows installer

This is the method of building the installer as of version 2014.7.4.

Clean the Environment

Make sure you don't have any leftover salt files from previous versions of salt in your Python directory.

  1. Remove all files that start with salt in the C:\Python27\Scripts directory
  2. Remove all files and directorys that start with salt in the C:\Python27\Lib\site-packages directory


Install salt using salt's From the C:\Salt-Dev\salt directory type the following command:

python install --force

Build the Installer

From cmd prompt go into the C:\Salt-Dev\salt\pkg\windows directory. Type the following command for the branch or tag of salt you're building:

BuildSalt.bat <branch or tag>

This will copy python with salt installed to the buildenv\bin directory, make it portable, and then create the windows installer . The .exe for the windows installer will be placed in the installer directory.

测试Salt minion

  1. 创建目录C:\salt (如果先前不存在的话)

  2. pkg/windows/buildenv/ 复制范例 confvar 目录到C:\salt

  3. 编辑C:\salt\conf\minion

    master: ipaddress or hostname of your salt-master
  4. 启动salt-minion

    cd C:\Python27\Scripts
    python salt-minion
  5. 在salt-master许可新的minion key

    sudo salt-key -A

    This accepts all unaccepted keys. If you're concerned about security just accept the key for this specific minion.

  6. 测试你的minion是否响应


    sudo salt '*'

You should get the following response: {'your minion hostname': True}


在一个64 bit Windows主机下面的脚本会无人值守安装salt,包括所有的依赖项:



# (All in one line.)

"PowerShell (New-Object System.Net.WebClient).DownloadFile('','C:\bootstrap.bat');(New-Object -com Shell.Application).ShellExecute('C:\bootstrap.bat');"


winexe -U "administrator" //fqdn "PowerShell (New-Object ......);"


Windows 2003以下的包管理

On windows Server 2003, you need to install optional component "wmi windows installer provider" to have full list of installed packages. If you don't have this, salt-minion can't report some installed software.