{"id":15167064,"url":"https://github.com/saltstack/saltwinshell","last_synced_at":"2025-09-30T23:30:41.474Z","repository":{"id":146505536,"uuid":"370823925","full_name":"saltstack/saltwinshell","owner":"saltstack","description":"Agentless Salt for Windows, compatible with salt-ssh","archived":true,"fork":false,"pushed_at":"2021-05-25T20:53:03.000Z","size":14,"stargazers_count":4,"open_issues_count":0,"forks_count":5,"subscribers_count":13,"default_branch":"main","last_synced_at":"2025-01-20T12:39:20.657Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"PowerShell","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/saltstack.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-05-25T20:48:01.000Z","updated_at":"2023-10-18T15:02:21.000Z","dependencies_parsed_at":"2023-07-04T09:31:47.407Z","dependency_job_id":null,"html_url":"https://github.com/saltstack/saltwinshell","commit_stats":{"total_commits":1,"total_committers":1,"mean_commits":1.0,"dds":0.0,"last_synced_commit":"afcc8516fc45b0d11d384bdcf730dcbb21ee30d7"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/saltstack/saltwinshell","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saltstack%2Fsaltwinshell","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saltstack%2Fsaltwinshell/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saltstack%2Fsaltwinshell/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saltstack%2Fsaltwinshell/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/saltstack","download_url":"https://codeload.github.com/saltstack/saltwinshell/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/saltstack%2Fsaltwinshell/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":277771955,"owners_count":25874476,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-30T02:00:09.208Z","response_time":75,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-09-27T05:24:09.601Z","updated_at":"2025-09-30T23:30:41.247Z","avatar_url":"https://github.com/saltstack.png","language":"PowerShell","readme":"# Agentless Salt for Windows\n\n\u003e **NOTE:** This is an _archived_ repository! Agentless Salt for Windows was originally created for SaltStack Enterprise customers and has not been updated since 2017. This repository is being open sourced, but the project is not supported at this time. Feel free to fork and make use of the code in accordance with the `LICENSE` file.\n\n## About\n\nThe Agentless Windows Module can run any Salt SSH command on a target Windows server or desktop, such as the following:\n\n```\nsalt-ssh testwin disk.usage\n```\n\n## Requirements\n\n### Target Windows systems\n\n- English version of Windows\n- Windows versions:\n  - Windows 7\n  - Windows 8.1\n  - Windows 10\n  - Windows Server 2008 R2\n  - Windows Server 2012 R2\n  - Windows Server 2016\n- Powershell 3.0 or later\n- WinRM must be configured and running\n\nWinrm must be set up and configured on the Windows machine to run https on port\n5986. The Windows firewall also must be set up to allow inbound port 5986.\n\nA convenience script is available in `enable_winrm.ps1`.\n\n### Salt master\n\n- The `/etc/salt/roster` file must have a configuration section for every Windows machine you want to connect to. The configuration must have a local admin user and password for each machine, as in the following example.\n\n```yaml\nwin2012dev: # Minion ID\n  host: \u003cIP address or hostname\u003e\n  user: \u003clocal Windows admin username\u003e\n  passwd: \u003cpassword for the admin user\u003e\n  winrm: True\n```\n\n\u003e **NOTE:** Domain credentials are not supported.\n\n- Python 2 must be installed on the Salt master. The `salt-ssh` module for Windows is supported only on Python 2, not later versions.\n- `pip` for Python 2 must be installed.\n\n#### CentOS\n\nTo install `pip` for Python 2 on CentOS:\n\n```bash\nyum install epel-release -y\nyum install python-pip\npip install -U setuptools\n```\n\n#### Ubuntu\n\nTo install `pip` for Python 2 on Ubuntu:\n\n```bash\napt-get install python-pip\n```\n\n## Installation instructions\n\nDownload the latest release onto your Salt Master:\n\nhttps://github.com/saltstack/saltwinshell/releases/download/v2017.7/saltwinshell-2017.7-cp27-cp27mu-linux_x86_64.whl\n\nInstall on your working Salt Master:\n\n```\npip install -U ./saltwinshell-2017.7-cp27-cp27mu-linux_x86_64.whl\n```\n\nOnce winrm is configured and running on your Windows system(s), you should be able to start using `salt-ssh`\nagainst them.\n\n```\nsalt-ssh \u003cminion id\u003e test.ping\n```\n\nThe first time you run `salt-ssh` against a Windows minion it will take a bit\nlonger than usual since it has to deploy a working Salt python environment.\nSubsequent runs should be much faster.\n\nThe shell libraries for agentless Windows to work via `salt-ssh`, installing\nthis library activates the ability to hit windows targets.\n\n## Release process\n\n- Create a new branch:\n\n```\ngit checkout -b \u003cnew branch name\u003e\n```\n\n- Make updates.\n- Create a tag:\n\n```\ngit tag -a v2018.3 -m \"Version v2018.3 release\" -s\ngit push origin 2018.3\ngit push --tags\n```\n\n- Copy in your python environment zip files to the root. Make sure they match\nwhat the setup.py is expecting.\n- Run the following:\n\n  ```\n  python setup.py bdist_wheel\n  ```\n\n  The file you want will be found in the `dist` directory and will look something  like:\n\n  ```\n  saltwinshell-2017.7-cp27-cp27mu-linux_x86_64.whl\n  ```\n\n- Upload `.whl` file as a new release on GitHub\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaltstack%2Fsaltwinshell","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsaltstack%2Fsaltwinshell","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaltstack%2Fsaltwinshell/lists"}