.. 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/badge/discord-SaltProject-blue.svg?logo=discord
:alt: Salt Project Discord Community
:target: https://discord.com/invite/J7b7EscrAs
.. 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.)
.. note::
When using salt-cloud -p with a profile, pass only the VM name on the
command line. Specify VM attributes (memory, cpu, vcpu, etc.) in the profile
configuration, not as command-line arguments.
Salt is the world's fastest, most intelligent and scalable automation
engine.
About Salt
Built on Python, Salt is an event-driven automation tool and framework to
deploy, configure, and manage complex IT systems. Use Salt to automate common
infrastructure administration tasks and ensure that all the components of your
infrastructure are operating in a consistent desired state.
Salt has many possible uses, including configuration management, which involves:
- Managing operating system deployment and configuration.
- Installing and configuring software applications and services.
- Managing servers, virtual machines, containers, databases, web servers,
network devices, and more.
- Ensuring consistent configuration and preventing configuration drift.
Salt is ideal for configuration management because it is pluggable,
customizable, and plays well with many existing technologies. Salt enables you
to deploy and manage applications that use any tech stack running on nearly any
operating system <https://docs.saltproject.io/salt/install-guide/en/latest/topics/salt-supported-operating-systems.html>_,
including different types of network devices such as switches and routers from a
variety of vendors.
In addition to configuration management Salt can also:
- Automate and orchestrate routine IT processes, such as common required tasks
for scheduled server downtimes or upgrading operating systems or applications.
- Create self-aware, self-healing systems that can automatically respond to
outages, common administration problems, or other important events.
About our sponsors
Salt powers VMware by Broadcom's VMware Salt_
(previously Aria Automation Config / vRealize Automation SaltStack Config / SaltStack Enterprise), and can be found
under the hood of products from Juniper, Cisco, Cloudflare, Nutanix, SUSE, and
Tieto, to name a few.
The original sponsor of our community, SaltStack, was acquired by VMware in 2020.
VMware was later acquired by Broadcom in 2023 <https://investors.broadcom.com/news-releases/news-release-details/broadcom-completes-acquisition-vmware>__.
The Salt Project remains an open source ecosystem that Broadcom supports and
contributes to. Broadcom ensures the code integrity and quality of the Salt
modules by acting as the official sponsor and manager of the Salt project. Many
of the core Salt Project contributors are also Broadcom employees. This team
carefully reviews and enhances the Salt modules to ensure speed, quality, and
security.
Download and install Salt
Salt is tested and packaged to run on CentOS, Debian, RHEL, Ubuntu, MacOS,
Windows, and more. Download Salt and get started now. See
supported operating systems <https://docs.saltproject.io/salt/install-guide/en/latest/topics/salt-supported-operating-systems.html>_
for more information.
To download and install Salt, see:
The Salt install guide <https://docs.saltproject.io/salt/install-guide/en/latest/index.html>_
Salt Project Repository: Linux (RPM) <https://packages.broadcom.com/artifactory/saltproject-rpm>__ - Where Salt rpm packages are officially stored and distributed.Salt Project Repository: Linux (DEB) <https://packages.broadcom.com/artifactory/saltproject-deb>__ - Where Salt deb packages are officially stored and distributed.Salt Project Repository: GENERIC <https://packages.broadcom.com/artifactory/saltproject-generic>__ - Where Salt Windows, macOS, etc. (non-rpm, non-deb) packages are officially stored and distributed.
Technical support
Report bugs or problems using Salt by opening an issue: <https://github.com/saltstack/salt/issues>_
To join our community forum where you can exchange ideas, best practices,
discuss technical support questions, and talk to project maintainers, join our
Discord server: Salt Project Community Discord_
Salt Project documentation
Installation instructions, tutorials, in-depth API and module documentation:
The Salt install guide <https://docs.saltproject.io/salt/install-guide/en/latest/index.html>_The Salt user guide <https://docs.saltproject.io/salt/user-guide/en/latest/>_Latest Salt documentation_Salt's contributing guide <https://docs.saltproject.io/en/master/topics/development/contributing.html>_
This is the beginning of the README. Read the rest at the original. Read the full README ↗
