.. _contents:

.. |vid| image:: /_static/film_link.png

.. _docs-tutorials:

Salt at a glance
================

Learn about the various parts of Salt in five minute increments (or less).

* **What is Salt?:**
  :doc:`Overview <topics/index>`
  | :doc:`Community </topics/community>`
* **The basics:**
  :doc:`Installation <topics/installation>`
  | :doc:`Configuration <topics/configuration>`
  | |vid| `Watch the screencast <http://blip.tv/saltstack/salt-installation-configuration-and-remote-execution-5713423>`_
* **Remote execution:**
  :doc:`Modules <topics/tutorials/modules>`
* **State management:**
  :doc:`Part 1 <topics/tutorials/states_pt1>`
  | :doc:`Part 2 <topics/tutorials/states_pt2>`
  | :doc:`Part 3 <topics/tutorials/states_pt3>`



.. _docs-reference:

Salt in depth
=============

While using and setting up Salt is a simple task, the capabilities of Salt run
much deeper. Gaining a better understanding of how Salt works will allow you to
get much more out of Salt.

* **Remote execution:**
  :doc:`Writing modules <ref/modules/index>`
  | :doc:`full list of modules <ref/modules/all/index>`
* **System info & detection:**
  :doc:`Grains <ref/grains>` 
* **Displaying or storing responses:**
  :doc:`Writing returners <ref/returners/index>`
  | :doc:`full list of returners <ref/returners/all/index>`
* **State enforcement:**
  :doc:`States <ref/states/index>`
  | :doc:`Highstate data structure <ref/states/highstate>`
  | :doc:`full list of states <ref/states/all/index>`
* **Renderers:**
  :doc:`Renderers <ref/renderers/index>`
  | :doc:`full list of renderers <ref/renderers/all/index>`
* **Transferring & syncing files:**
  :doc:`File Server <ref/file_server/index>`
* **Network topology:**
  :doc:`ref/syndic`
  | :doc:`ref/peer`
* **Configuration:**
  :doc:`Full list of minion settings <ref/configuration/minion>`
  | :doc:`Full list of master settings <ref/configuration/master>`
* **Using Salt:**
  :doc:`From the command-line <ref/cli/index>`
  | :doc:`Through the Python API <ref/python-api>`

.. admonition:: Screencasts and presentations

    * Thomas S. Hatch was `interviewed on episode 191 of FLOSS Weekly
      <http://twit.tv/show/floss-weekly/191>`_.
    * Presentation at the Salt Lake Linux User Group (SLLUG) in May 2011
      `video <http://blip.tv/thomas-s-hatch/salt-0-8-7-presentation-5180182>`_
      | :download:`slides <Salt.pdf>` (PDF)

Salt quick reference
====================

* :doc:`Release notes </topics/releases/index>`
  | :doc:`Roadmap </topics/roadmap/index>`
* :ref:`modindex`
  | :ref:`genindex`
  | :doc:`Full table of contents </contents>`
* :ref:`search`