Software to automate the management and configuration of any infrastructure or application at scale. Get access to the Salt software package repository here:
Go to file
2019-04-20 18:08:51 +01:00
.ci Create nox lint virtualenvs before running them 2019-04-19 09:04:17 +01:00
.github ci/lint corrected filenames and test condition on full lint 2018-11-29 23:44:11 +11:00
conf Remove event_publisher_pub_hwm and salt_event_pub_hwm from documentation 2018-10-08 10:51:01 -04:00
doc Merge pull request #51770 from Ch3LL/doc_conf_2017 2019-02-25 09:11:22 -05:00
pkg Add TLS support up to version 1.2 2019-04-12 14:07:20 -06:00
requirements impacket does not support Py3 2019-04-19 18:56:47 +01:00
salt Default to Cryptodome, fallback to PyCrypto 2019-04-17 16:12:16 +01:00
scripts Adding salt-minion watchdog for sysV systems (rhel6 and sles11) 2017-06-20 17:28:40 +01:00
templates Fix all Sphinx warnings 2018-05-31 15:28:25 -05:00
tests Include COVERAGE_FILE as an env variable. 2019-04-20 18:07:47 +01:00
.codeclimate.yml Configuration file for Code Climate static code analysis. 2015-05-05 13:49:46 -03:00
.codecov.yml Add 2017.7 codecov config 2019-01-24 13:26:16 +00:00
.coveragerc Add .coveragerc 2019-01-24 16:58:41 +00:00
.editorconfig Added .editorconfig for easier editing. 2015-10-04 21:35:51 -04:00
.gitignore Also ignore multiprocessing coverage files 2019-04-17 16:12:13 +01:00
.kitchen.yml Fix docker entries 2019-04-17 16:12:14 +01:00
.mention-bot Always notify tkwilliams when changes occur on boto files 2017-08-29 11:17:41 -04:00
.pre-commit-config.yaml Add a cloud nox session for both runtests and pytest 2019-04-18 18:53:49 +01:00
.pylintrc ignore salt.ext in pylint 2018-01-09 17:49:50 -07:00
.testing.pylintrc Fix lint issues on salt 2019-04-17 16:12:09 +01:00
AUTHORS Merge pull request #39841 from rafaelcaricio/telegram-beacon 2017-03-14 13:30:37 -06:00
CONDUCT.md SaltStack's code of conduct 2016-09-16 00:32:01 +09:00
COPYING Update Salt's licensing information to include cptestcase 2016-09-01 18:46:13 +09:00
Gemfile Specify the SHA we need 2019-04-17 16:12:14 +01:00
HACKING.rst Merge branch '2016.11' into 'develop' 2017-01-03 10:17:18 -05:00
LICENSE Updated copyright to 2016 2016-01-01 01:31:48 +00:00
MANIFEST.in move requirements files into requirements dir 2014-12-27 17:29:03 -07:00
noxfile.py As a script, not as a module 2019-04-20 18:08:51 +01:00
Pipfile Update pytest requirements 2019-01-19 18:37:41 +00:00
README.rst Update README with SaltConf18 info 2017-12-12 11:32:34 -05:00
setup.py Strings and integers are not comparable under Python 3 2019-04-17 16:12:11 +01:00
tox.ini Add initial nox configuration. Tell tox'ers to use nox'. 2019-02-20 17:04:32 +00:00

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

==================
What is SaltStack?
==================

SaltStack makes software for complex systems management at scale.
SaltStack is the company that created and maintains the Salt Open
project and develops and sells SaltStack Enterprise software, services
and support. Easy enough to get running in minutes, scalable enough to
manage tens of thousands of servers, and fast enough to communicate with
them in *seconds*.

Salt is a new approach to infrastructure management built on a dynamic
communication bus. Salt can be used for data-driven orchestration,
remote execution for any infrastructure, configuration management for
any app stack, and much more.

Download Salt Open
==================

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

`<https://repo.saltstack.com/>`_

`Installation Instructions <https://docs.saltstack.com/en/latest/topics/installation/index.html>`_

SaltStack Documentation
=======================

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

`<https://docs.saltstack.com/en/getstarted/>`_

`<https://docs.saltstack.com/en/latest/>`_

Get SaltStack Support and Help
==============================

**IRC Chat** - Join the vibrant, helpful and positive SaltStack chat room in
Freenode at #salt. There is no need to introduce yourself, or ask permission to
join in, just help and be helped! Make sure to wait for an answer, sometimes it
may take a few moments for someone to reply.

`<http://webchat.freenode.net/?channels=salt&uio=Mj10cnVlJjk9dHJ1ZSYxMD10cnVl83>`_

**Mailing List** - The SaltStack community users mailing list is hosted by
Google groups. Anyone can post to ask questions about SaltStack products and
anyone can help answer. Join the conversation!

`<https://groups.google.com/forum/#!forum/salt-users>`_

You may subscribe to the list without a Google account by emailing
salt-users+subscribe@googlegroups.com and you may post to the list by emailing
salt-users@googlegroups.com

**Reporting Issues** - To report an issue with Salt, please follow the
guidelines for filing bug reports:
`<https://docs.saltstack.com/en/develop/topics/development/reporting_bugs.html>`_

**SaltStack Support** - If you need dedicated, prioritized support, please
consider a SaltStack Support package that fits your needs:
`<http://www.saltstack.com/support>`_

Engage SaltStack
================

`SaltConf`_, **User Groups and Meetups** - SaltStack has a vibrant and `global
community`_ of customers, users, developers and enthusiasts. Connect with other
Salted folks in your area of the world, or join `SaltConf18`_, the SaltStack
annual user conference, September 10-14 in Salt Lake City. Please let us know if
you would like to start a user group or if we should add your existing
SaltStack user group to this list by emailing: info@saltstack.com

**SaltStack Training** - Get access to proprietary `SaltStack education
offerings`_ through instructor-led training offered on-site, virtually or at
SaltStack headquarters in Salt Lake City. SaltStack Enterprise training helps
increase the value and effectiveness of SaltStack software for any customer and
is a prerequisite for coveted `SaltStack Certified Engineer (SSCE)`_ status.
SaltStack training is also available through several `SaltStack professional
services`_ offerings.

**Follow SaltStack on -**

* YouTube - `<http://www.youtube.com/saltstack>`_
* Twitter - `<http://www.twitter.com/saltstack>`_
* Facebook - `<https://www.facebook.com/SaltStack/>`_
* LinkedIn - `<https://www.linkedin.com/company/salt-stack-inc>`_
* LinkedIn Group - `<https://www.linkedin.com/groups/4877160>`_
* Google+ - `<https://plus.google.com/b/112856352920437801867/+SaltStackInc/posts>`_

.. _SaltConf: http://www.youtube.com/user/saltstack
.. _global community: http://www.meetup.com/pro/saltstack/
.. _SaltConf18: http://saltconf.com/
.. _SaltStack education offerings: http://saltstack.com/training/
.. _SaltStack Certified Engineer (SSCE): http://saltstack.com/certification/
.. _SaltStack professional services: http://saltstack.com/services/

Developing Salt
===============

The Salt development team is welcoming, positive, and dedicated to
helping people get new code and fixes into SaltStack projects. Log into
GitHub and get started with one of the largest developer communities in
the world. The following links should get you started:

`<https://github.com/saltstack>`_

`<https://docs.saltstack.com/en/latest/topics/development/index.html>`_

`<https://docs.saltstack.com/en/develop/topics/development/pull_requests.html>`_