Windows

### Navigation

- index
- modules |
- next |
- previous |
- « SaltStack.org |
- Documentation home
- Installation »

# Windows

Salt currently has experimental support for Salt Minions on Windows.

There are no plans for the forseeable future to develop a Salt Master on Windows. For now you must run your Salt Master on a supported operating system to control your Salt Minions on Windows.

Many of the standard Salt modules have been ported to work on Windows and many of the Salt States currently work on Windows, as well.

## Installation from source

Work is under way to create a Windows installer for Salt, but for now one must install each dependency separately and configure Salt to run on your Windows host.

Rather than send you on a wild goose chase across the Internet, we've collected some of the more difficult to find installers in our github repo for you.

## Install on Windows XP 32bit

1. Install msysgit
   1. Clone the Salt git repository from github

    git clone git://github.com/saltstack/salt.git

2. Install Microsoft Visual Studio 2008 Express. You must use Visual Studio 2008 Express, not Visual Studio 2010 Express.
3. Install Python 2.7.x
4. Add c:\Python27 to your system path
5. Install the Microsoft Visuall C++ 2008 SP1 Redistributable, vcredist_x86.
6. Install Win32OpenSSL-1_0_0e.exe
   1. Choose first option to install in Windows system directory
7. Install pyzmq-2.1.11.win32-py2.7.msi
8. Install pycrypto-2.3.win32-py2.7.msi
9. Install PyYAML-3.10.win32-py2.7.msi
10. Install Cython-0.15.1.win32-py2.79.exe
11. Download and run distribute_setup.py

    python distribute_setup.py

12. Download and run pip

    python get-pip.py

13. Add c:\python27\scripts to your path
14. Close terminal window and open a new terminal window (cmd)
15. Install jinja2

    pip install jinja2

16. Install Messagepack

    pip install msgpack-python

17. Install Salt

    cd ./salt
    python setup.py install

18. Edit c:\etc\salt\minon

    master: ipaddress or hostname of your salt-master
    master_port: 4506
    root_dir: c:\
    pki_dir: /etc/salt/pki
    cachedir: /var/cache/salt
    renderer: yaml_jinja
    open_mode: False
    multiprocessing: False

19. Start the salt-minion

    cd c:\python27\scripts
    python salt-minion

20. On the salt-master accept the new minion's key

    sudo salt-key -A

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

21. Test that your minion is responding

    > 1. On the salt-master run:

    sudo salt '*' test.ping

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

## Single command bootstrap script

On a 64 bit Windows host the following script makes an unattended install of salt including all dependencies:

    "PowerShell (New-Object System.Net.WebClient).DownloadFile('http://csa-net.dk/salt/bootstrap64.bat','C:\bootstrap.bat');(New-Object -com Shell.Application).ShellExecute('C:\bootstrap.bat');"

    (All in one line.)

You can execute the above command remotely from a linux host using winexe:

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

For more info check http://csa-net.dk/salt

## Comments

comments powered by Disqus

### Navigation

- index
- modules |
- next |
- previous |
- « SaltStack.org |
- Documentation home
- Installation »