Software to automate the management and configuration of any infrastructure or application at scale. Get access to the Salt software package repository here: https://repo.saltproject.io/
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Adam Mendlik 1671aab431 Add change log for issue 61094 4 months ago
.github use yaml highlight for version report in bug template 4 months ago
.pre-commit-hooks Merge 3003.3 into master (#60924) 10 months ago
changelog Add change log for issue 61094 4 months ago
cicd Bump amazon ci timeout to 7 4 months ago
conf fixes saltstack/salt#61708 add grains_refresh_pre_exec option for minions 4 months ago
doc Fix various spelling mistakes in release notes 4 months ago
pkg Edit RST files on a mac so that line endings and fonts are correct 6 months ago
requirements update requirements for pytest-httpserver and fix test_http_query 4 months ago
rfcs Port #50553 to master 2 years ago
salt Set virtual grain on EC2 instances 4 months ago
scripts Deprecating and removing salt-unity. 7 months ago
tasks Add missing docstrings 4 months ago
templates Pyupgrade and drop six 1 year ago
tests long line now short line 4 months ago
.bandit Address Bandit's B602(subprocess_popen_with_shell_equals_true) on the test suite 1 year ago
.codeclimate.yml Tweak codeclimate settings for less noise 3 years ago
.codecov.yml Set codecov's status setting to false 2 years ago
.coveragerc Teach coverage a bit more about salt paths. 2 years ago
.editorconfig
.git-blame-ignore-revs Update ignored revisions for git-blame 1 year ago
.gitattributes Update changelog 2 years ago
.gitignore update .gitignore 12 months ago
.gitlab-ci.yml Revert "Add ShiftLeft Scan to the pipeline" 2 years ago
.mention-bot Always notify tkwilliams when changes occur on boto files 5 years ago
.pre-commit-config.yaml Fix docs requirements 5 months ago
.pylintrc No string formatting in log calls 12 months ago
.rstcheck.cfg Start checking rst files at pre-commit level with `rstcheck` 2 years ago
AUTHORS Updating email references from nmadhok@clemson.edu to nmadhok@g.clemson.edu 1 year ago
CHANGELOG.md Fix spelling mistake of "every time" 7 months ago
CODE_OF_CONDUCT.md Updating to v2.0 of contributor covenant 2 years ago
CONTRIBUTING.rst Add imagemagick prereq (#60771) 10 months ago
DEPENDENCIES.md Add dates of copyright to dependencies 2 years ago
Gemfile Use main branch for kitchen-docker project 5 months ago
LICENSE Fix path in license 2 years ago
MANIFEST.in add run.py to the sdist tarball 1 year ago
README.rst Update documentation to avoid reference to freenode. 1 year ago
SECURITY.md Updating links to point to master branch docs 1 year ago
SUPPORT.rst change docs.saltstack.com to docs.saltproject.io everywhere 10 months ago
kitchen.yml Change to https:// URL 6 months ago
noxfile.py Address test accounts not able to write coverage data 4 months ago
pyproject.toml Merge 3003.3 into master (#60924) 10 months ago
pytest.ini Upgrade to PyTest 5.x 2 years ago
run.py Re-enable tiamat-pip on windows 5 months ago
setup.cfg Use root as user:owner in sdist generated tars 1 year ago
setup.py Stop stripping the requirements markers. 4 months ago

README.rst

.. image:: https://img.shields.io/github/license/saltstack/salt
:alt: Salt Project License: Apache v2.0
:target: https://github.com/saltstack/salt/blob/master/LICENSE

.. image:: https://img.shields.io/pypi/dm/salt?label=pypi%20downloads
:alt: PyPi Package Downloads
:target: https://pypi.org/project/salt

.. image:: https://img.shields.io/lgtm/grade/python/github/saltstack/salt
:alt: PyPi Package Downloads
:target: https://lgtm.com/projects/g/saltstack/salt/context:python

.. image:: https://img.shields.io/badge/slack-@saltstackcommunity-blue.svg?logo=slack
:alt: Salt Project Slack Community
:target: https://join.slack.com/t/saltstackcommunity/shared_invite/zt-3av8jjyf-oBQ2M0vhXOhJpNpRkPWBvg

.. image:: https://img.shields.io/twitch/status/saltprojectoss
:alt: Salt Project Twitch Channel
:target: https://www.twitch.tv/saltprojectoss

.. image:: https://img.shields.io/reddit/subreddit-subscribers/saltstack?style=social
:alt: Salt Project subreddit
:target: https://www.reddit.com/r/saltstack/

.. image:: https://img.shields.io/twitter/follow/Salt_Project_OS?style=social&logo=twitter
:alt: Follow SaltStack on Twitter
:target: https://twitter.com/intent/follow?screen_name=Salt_Project_OS

.. figure:: https://gitlab.com/saltstack/open/salt-branding-guide/-/raw/master/logos/SaltProject_altlogo_teal.png?inline=true
:scale: 80 %
:width: 1000px
:height: 356px
:align: center
:alt: Salt Project Logo

* `Latest Salt Documentation`_
* `Open an issue`_ (bug report, feature request, etc.)

*Salt is the world’s fastest, most intelligent and scalable automation*
*engine.*

About Salt
==========

Built on python, Salt uses simple and human-readable YAML combined with
event-driven automation to deploy and configure complex IT systems. In addition
to leveling-up `vRealize Automation SaltStack Config`_, Salt can be found under
the hood of products from Juniper, Cisco, Cloudflare, Nutanix, SUSE, and Tieto,
to name a few.

About SaltStack
===============

`SaltStack was acquired by VMware in 2020 <https://www.vmware.com/company/acquisitions/saltstack.html>`_.
Salt Project remains an open source ecosystem that VMware supports and
contributes to.

Download Salt
=============

Salt is tested and packaged to run on CentOS, Debian, RHEL, Ubuntu, MacOS,
Windows, and more. Download Salt and get started now.

* `<https://repo.saltproject.io/>`_
* `Installation Instructions <https://docs.saltproject.io/en/master/topics/installation/index.html>`_

Salt Project Documentation
==========================

Installation instructions, getting started guides, in-depth API
documentation, and contributing to Salt.

* `Getting Started with Salt <https://docs.saltproject.io/en/getstarted/>`_
* `Latest Salt Documentation`_
* `Salt’s Contributor Guide <https://docs.saltproject.io/en/master/topics/development/contributing.html>`_

Security Advisories
===================

Keep an eye on the Salt Project
`Security Announcements <https://saltproject.io/security-announcements/>`_
landing page. Salt Project recommends subscribing to the
`Salt Project Security RSS feed <https://saltproject.io/feed/?post_type=security>`_
to receive notification when new information is available regarding security
announcements.

Other channels to receive security announcements include the
`Salt Community mailing list <https://groups.google.com/forum/#!forum/salt-users>`_
and the
`Salt Project Community Slack`_.

Responsibly Reporting Security Vulnerabilities
++++++++++++++++++++++++++++++++++++++++++++++

When reporting security vulnerabilities for Salt or other SaltStack projects,
refer to the `SECURITY.md`_ file found in this repository.

Engage the Salt Project and The Community
=========================================

Please be sure to review our
`Code of Conduct <https://github.com/saltstack/salt/blob/master/CODE_OF_CONDUCT.md>`_.
Also, check out some of our community resources including:

* `Salt Project Community Wiki <https://github.com/saltstack/community/wiki>`_
* `Salt Project Community Slack`_
* `Salt Project: IRC on LiberaChat <https://web.libera.chat/#salt>`_
* `Salt Project YouTube channel <https://www.youtube.com/channel/UCpveTIucFx9ljGelW63-BWg>`_
* `Salt Project Twitch channel <https://www.twitch.tv/saltprojectoss>`_

There are lots of ways to get involved in our community. Every month, there are
around a dozen opportunities to meet with other contributors and the Salt Core
team and collaborate in real time. The best way to keep track is by subscribing
to the **Salt Project Community Events Calendar** on the main
`<https://saltproject.io>`_ website.

If you have additional questions, email us at saltproject@vmware.com or reach out
directly to the Community Manager, Janae Andrus via Slack. We’d be glad to
have you join our community!

License
=======

Salt is licensed under the Apache 2.0 license. Please
see the
`LICENSE file <https://github.com/saltstack/salt/blob/master/LICENSE>`_ for the
full text of the Apache license, followed by a full summary of the licensing
used by external modules.

A complete list of attributions and dependencies can be found here:
`salt/DEPENDENCIES.md <https://github.com/saltstack/salt/blob/master/DEPENDENCIES.md>`_

.. _Salt Project Community Slack: https://join.slack.com/t/saltstackcommunity/shared_invite/zt-3av8jjyf-oBQ2M0vhXOhJpNpRkPWBvg
.. _vRealize Automation SaltStack Config: https://www.vmware.com/products/vrealize-automation/saltstack-config.html
.. _Latest Salt Documentation: https://docs.saltproject.io/en/latest/
.. _Open an issue: https://github.com/saltstack/salt/issues/new/choose
.. _SECURITY.md: https://github.com/saltstack/salt/blob/master/SECURITY.md
.. _Calendar html: https://outlook.office365.com/owa/calendar/105f69bacd4541baa849529aed37eb2d@vmware.com/434ec2155b2b4cce90144c87f0dd03d56626754050155294962/calendar.html
.. _Calendar ics: https://outlook.office365.com/owa/calendar/105f69bacd4541baa849529aed37eb2d@vmware.com/434ec2155b2b4cce90144c87f0dd03d56626754050155294962/calendar.ics