Salt Table of Contents¶

Frequently Asked Questions
- Is Salt open-core?
- What ports should I open on my firewall?
- I'm seeing weird behavior (including but not limited to packages not installing their users properly)
- My script runs every time I run a state.highstate. Why?
- When I run test.ping, why don't the Minions that aren't responding return anything? Returning False would be helpful.
- How does Salt determine the Minion's id?
- I'm trying to manage packages/services but I get an error saying that the state is not available. Why?
- I'm using gitfs and my custom modules/states/etc are not syncing. Why?
- Why aren't my custom modules/states/etc. available on my Minions?
- Module X isn't available, even though the shell command it uses is installed. Why?
- Can I run different versions of Salt on my Master and Minion?
- Does Salt support backing up managed files?
Introduction to Salt
- The 30 second summary
- Simplicity
- Parallel execution
- Building on proven technology
- Python client interface
- Fast, flexible, scalable
- Open
Installation
- Quick Install
- Platform-specific installation instructions
- Dependencies
- Optional Dependencies
- Upgrading Salt
Configuring Salt
- Master Configuration
- Minion Configuration
- Running Salt
- Key Management
- Sending Commands
- What's Next?
Developing Salt
- Sending a GitHub pull request
- Keeping Salt Forks in Sync
- Posting patches to the mailing list
- Installing Salt for development
  - Running a self-contained development version
- Installing Salt from the Python Package Index
- Editing and previewing the documentation
- Running unit and integration tests
Targeting
- Matching the minion id
- Grains
- Node groups
- Compound matchers
- Batch Size
Salt tutorials
- Introduction
  - Salt Masterless Quickstart
- Basics
- States
- Advanced Topics
- Salt Cloud
  - Salt as a Cloud Controller
- Halite
  - Installing and Configuring Halite
Access Control System
External Authentication System
- Tokens
Pillar of Salt
- Declaring the Master Pillar
- Pillar namespace flattened
- Including Other Pillars
- Viewing Minion Pillar
- Pillar "get" Function
- Refreshing Pillar Data
- Targeting with Pillar
- Master Config In Pillar
Master Tops System
Job Management
- The Minion proc System
- Functions in the saltutil Module
- The jobs Runner
Salt Scheduling
- States
- Highstates
- Runners
- Scheduler With Returner
Running the Salt Master/Minion as an Unprivileged User
Troubleshooting
- Troubleshooting the Salt Master
- Troubleshooting the Salt Minion
- Running in the Foreground
- What Ports do the Master and Minion Need Open?
- Using salt-call
- Too many open files
- Salt Master Stops Responding
- Salt and SELinux
- Red Hat Enterprise Linux 5
- Common YAML Gotchas
- Live Python Debug Output
- Salt 0.16.x minions cannot communicate with a 0.17.x master
Troubleshooting the Salt Master
- Running in the Foreground
- What Ports does the Master Need Open?
- Too many open files
- Salt Master Stops Responding
- Live Python Debug Output
- Commands Time Out or Do Not Return Output
- Passing the -c Option to Salt Returns a Permissions Error
Troubleshooting the Salt Minion
- Running in the Foreground
- What Ports does the Minion Need Open?
- Using salt-call
- Live Python Debug Output
YAML Idiosyncrasies
- Spaces vs Tabs
- Indentation
  - Nested Dicts (key=value)
- True/False, Yes/No, On/Off
- Integers are Parsed as Integers
- YAML does not like "Double Short Decs"
- YAML support only plain ASCII
- Underscores stripped in Integer Definitions
- Automatic datetime conversion
Community
- Mailing List
- IRC
- Follow on Github
- Blogs
- Example Salt States
- Follow on ohloh
- Other community links
- Hack the Source
Salt Based Projects
- Salt Sandbox
Salt Event System
- Listening for Events
- Firing Events
- Firing Events From Code
The Salt Mine
- Mine Functions
- Mine Interval
Salt Cloud Documentation
Getting Started
Core Configuration
Windows Configuration
Using Salt Cloud
Miscellaneous Options
Troubleshooting Steps
Extending Salt Cloud
Using Salt Cloud from Salt
Feature Comparison
Legacy Releases
Reference
Virtual Machine Disk Profiles
- Define More Profiles
Salt Virt - The SaltStack Cloud Controller
- Salt Virt Tutorial
- The Salt Virt Runner
- Based on Live State Data
Virtual Machine Network Profiles
- Define More Profiles
Salt SSH
- Salt SSH Roster
- Calling Salt SSH
  - Raw Shell Calls
- States Via Salt SSH
- Targeting with Salt SSH
- Configuring Salt SSH
- Running Salt SSH as non-root user
Salt Rosters
- How Rosters Work
  - Targets Data
Running The Tests
- Running The Tests In A Docker Container
Writing Tests
- Integration Tests
- Unit Tests
Integration Tests
- Integration Classes
- Examples
  - Module Example via ModuleCase Class
  - Shell Example via ShellCase
Writing Unit Tests
- Introduction
- Preparing to Write a Unit Test
- A Simple Example
- Evaluating Truth
- Tests Using Mock Objects
- Modifying __salt__ In Place
Reactor System
- Event System
- Mapping Events to Reactor SLS Files
- Fire an event
- Knowing what event is being fired
- Understanding the Structure of Reactor Formulas
- A complete example
Salt Formulas
- Installation
  - Adding a Formula as a GitFS remote
  - Adding a Formula directory manually
- Usage
- Writing Formulas
Salt Conventions
- Salt Formulas
- SaltStack Packaging Guide
- Salt Release Process
  - Feature Release Process
  - Maintenance and Bugfix Releases
- Salt Coding Style
SaltStack Packaging Guide
- Source Files
- Single Package
- Split Package
  - Salt Common
  - Salt Master
  - Salt Syndic
  - Salt Minion
  - Salt SSH
  - Salt Doc
  - Name
Salt Release Process
- Feature Release Process
- Maintenance and Bugfix Releases
Salt Coding Style
- Linting
- Strings
- Imports
  - Absolute Imports
- Vertical is Better
- Indenting
- Code Churn
SaltStack Git Policy
- New Code Entry
- Release Branching
  - Feature Release Branching
  - Point Releases
Salt Development Guidelines
- Deprecating Code
- Dunder Dictionaries
- External Pillars
- Logging Internals
- Modular Systems
  - Execution Modules
  - State Modules
  - Auth
  - Fileserver
  - Grains
  - Output
  - Pillar
  - Renderers
  - Returners
  - Runners
  - Tops
  - Wheel
- Package Providers
Translating Documentation
- Building A Localized Version of the Documentation
Community Projects That Use Salt
Salt Proxy Minion Documentation
- Getting Started
  - Configuration parameters on the master
  - Proxytypes
- The __proxyenabled__ directive
Logging
- Available Configuration Settings
External Logging Handlers
- Logstash Logging Handler
  - UDP Logging Handler
  - ZeroMQ Logging Handler
- Sentry Logging Handler
  - Threaded Transports
Logstash Logging Handler
- UDP Logging Handler
- ZeroMQ Logging Handler
  - Log Level
  - HWM
Sentry Logging Handler
- Threaded Transports
Introduction to Extending Salt
- Client API
- Adding Loadable Plugins
Execution Modules
- Modules Are Easy to Write!
- Cross Calling Modules
- Preloaded Modules Data
  - Grains Data
  - Module Configuration
- Printout Configuration
- Virtual Modules
- Documentation
  - Adding Documentation to Salt Modules
  - Add Module metadata
- How Functions are Read
  - Objects Loaded Into the Salt Minion
  - Objects NOT Loaded into the Salt Minion
- Useful Decorators for Modules
  - Depends Decorator
- Examples of Salt Modules
Full list of builtin execution modules
- salt.modules.pkg
- salt.modules.aliases
- salt.modules.alternatives
- salt.modules.apache
- salt.modules.aptpkg
- salt.modules.archive
- salt.modules.at
- salt.modules.augeas_cfg
- salt.modules.aws_sqs
- salt.modules.bluez
- salt.modules.brew
- salt.modules.bridge
- salt.modules.bsd_shadow
- salt.modules.cassandra
- salt.modules.chocolatey
- salt.modules.cloud
- salt.modules.cmdmod
- salt.modules.composer
- salt.modules.config
- salt.modules.cp
- salt.modules.cron
- salt.modules.daemontools
- salt.modules.darwin_sysctl
- salt.modules.data
- salt.modules.ddns
- salt.modules.debconfmod
- salt.modules.debian_ip
- salt.modules.debian_service
- salt.modules.dig
- salt.modules.disk
- salt.modules.djangomod
- salt.modules.dnsmasq
- salt.modules.dnsutil
- salt.modules.dockerio
  - Management of dockers
- salt.modules.dpkg
- salt.modules.ebuild
- salt.modules.eix
- salt.modules.eselect
- salt.modules.event
- salt.modules.extfs
- salt.modules.file
- salt.modules.freebsd_sysctl
- salt.modules.freebsdjail
- salt.modules.freebsdkmod
- salt.modules.freebsdpkg
- salt.modules.freebsdports
- salt.modules.freebsdservice
- salt.modules.gem
- salt.modules.gentoo_service
- salt.modules.gentoolkitmod
- salt.modules.git
- salt.modules.glance
- salt.modules.gnomedesktop
- salt.modules.grains
- salt.modules.groupadd
- salt.modules.grub_legacy
- salt.modules.guestfs
- salt.modules.hg
- salt.modules.hosts
- salt.modules.htpasswd
- salt.modules.img
- salt.modules.iptables
- salt.modules.key
- salt.modules.keyboard
- salt.modules.keystone
- salt.modules.kmod
- salt.modules.launchctl
- salt.modules.layman
- salt.modules.ldapmod
- salt.modules.linux_acl
- salt.modules.linux_lvm
- salt.modules.linux_sysctl
- salt.modules.localemod
- salt.modules.locate
- salt.modules.logrotate
- salt.modules.lvs
- salt.modules.lxc
- salt.modules.mac_group
- salt.modules.mac_user
- salt.modules.makeconf
- salt.modules.match
- salt.modules.mdadm
- salt.modules.memcached
  - Module for Management of Memcached Keys
- salt.modules.mine
- salt.modules.modjk
- salt.modules.mongodb
- salt.modules.monit
- salt.modules.moosefs
- salt.modules.mount
- salt.modules.munin
- salt.modules.mysql
- salt.modules.netbsd_sysctl
- salt.modules.netbsdservice
- salt.modules.network
- salt.modules.nfs3
- salt.modules.nginx
- salt.modules.nova
- salt.modules.npm
- salt.modules.omapi
- salt.modules.openbsdpkg
- salt.modules.openbsdservice
- salt.modules.openstack_config
- salt.modules.osxdesktop
- salt.modules.pacman
- salt.modules.pagerduty
- salt.modules.pam
- salt.modules.parted
- salt.modules.pecl
- salt.modules.pillar
- salt.modules.pip
- salt.modules.pkg_resource
- salt.modules.pkgin
- salt.modules.pkgng
- salt.modules.pkgutil
- salt.modules.portage_config
- salt.modules.postgres
- salt.modules.poudriere
- salt.modules.powerpath
- salt.modules.ps
- salt.modules.publish
- salt.modules.puppet
- salt.modules.pw_group
- salt.modules.pw_user
- salt.modules.qemu_img
  - Qemu-img Command Wrapper
- salt.modules.qemu_nbd
  - Qemu Command Wrapper
- salt.modules.quota
- salt.modules.rabbitmq
- salt.modules.rbenv
- salt.modules.rdp
- salt.modules.reg
- salt.modules.ret
- salt.modules.rh_ip
- salt.modules.rh_service
- salt.modules.riak
  - Riak Salt Module
- salt.modules.rpm
- salt.modules.rvm
- salt.modules.s3
- salt.modules.saltcloudmod
- salt.modules.saltutil
- salt.modules.seed
- salt.modules.selinux
- salt.modules.service
- salt.modules.shadow
- salt.modules.smartos_imgadm
- salt.modules.smartos_vmadm
- salt.modules.smf
- salt.modules.solaris_group
- salt.modules.solaris_shadow
- salt.modules.solaris_user
- salt.modules.solarispkg
- salt.modules.solr
  - Apache Solr Salt Module
- salt.modules.sqlite3
- salt.modules.ssh
- salt.modules.state
- salt.modules.status
- salt.modules.supervisord
- salt.modules.svn
- salt.modules.sysbench
- salt.modules.sysmod
- salt.modules.system
- salt.modules.systemd
- salt.modules.test
- salt.modules.timezone
- salt.modules.tls
- salt.modules.tomcat
- salt.modules.upstart
- salt.modules.useradd
- salt.modules.virt
- salt.modules.virtualenv
- salt.modules.win_autoruns
- salt.modules.win_disk
- salt.modules.win_dns_client
- salt.modules.win_file
- salt.modules.win_firewall
- salt.modules.win_groupadd
- salt.modules.win_ip
- salt.modules.win_network
- salt.modules.win_ntp
- salt.modules.win_path
- salt.modules.win_pkg
- salt.modules.win_repo
- salt.modules.win_servermanager
- salt.modules.win_service
- salt.modules.win_shadow
- salt.modules.win_status
- salt.modules.win_system
- salt.modules.win_timezone
- salt.modules.win_useradd
- salt.modules.xapi
- salt.modules.xmpp
- salt.modules.yumpkg
- salt.modules.zcbuildout
  - Management of zc.buildout
- salt.modules.zfs
- salt.modules.zpool
- salt.modules.zypper
Returners
- Using Returners
- Writing a Returner
  - Examples
Full list of builtin returner modules
- salt.returners.carbon_return
- salt.returners.cassandra_return
- salt.returners.couchdb_return
- salt.returners.local
- salt.returners.memcache_return
- salt.returners.mongo_future_return
- salt.returners.mongo_return
- salt.returners.mysql
- salt.returners.postgres
- salt.returners.redis_return
- salt.returners.sentry_return
- salt.returners.smtp_return
- salt.returners.sqlite3
- salt.returners.syslog_return
File State Backups
- Backed-up Files
- Interacting with Backups
Extending External SLS Data
- The Extend Declaration
- Extend is a Top Level Declaration
- The Requisite "in" Statement
- Rules to Extend By
Failhard Global Option
- State Level Failhard
- Global Failhard
Highstate data structure definitions
- The Salt State Tree
- Large example
Include and Exclude
- Include
- Relative Include
- Exclude
State Enforcement
- State management
- Understanding the Salt State System Components
State System Layers
- Function Call
- Low Chunk
- Low State
- High Data
- SLS
- HighState
- OverState
The Orchestrate Runner
Ordering States
- State Auto Ordering
- Requisite Statements
- The Order Option
OverState System
State Providers
- Setting a Provider in the Minion Config File
- Arbitrary Module Redirects
Requisites
- Requisite and Requisite in types
  - Require
  - Require an entire sls file
  - Watch
  - Prereq
  - Use
  - Require In
  - Watch In
  - Prereq In
Startup States
- Examples:
State Testing
- Default Test
The Top File
- Environments
- Other Ways of Targeting Minions
- How Top Files Are Compiled
SLS Template Variable Reference
- Salt
- Opts
- Pillar
- Grains
- env
- sls
State Modules
- States are Easy to Write!
- Using Custom State Modules
- Cross Calling Modules
- Return Data
- Test State
- Watcher Function
- Mod_init Interface
Full list of builtin state modules
- salt.states.alias
  - Configuration of email aliases
- salt.states.alternatives
  - Configuration of the alternatives system
- salt.states.apt
  - Package management operations specific to APT- and DEB-based systems
- salt.states.archive
- salt.states.augeas
  - Configuration management using Augeas
- salt.states.aws_sqs
  - Manage SQS Queues
- salt.states.cloud
  - Using states instead of maps to deploy clouds
- salt.states.cmd
  - Execution of arbitrary commands
- salt.states.composer
  - Installation of Composer Packages
- salt.states.cron
  - Management of cron, the Unix command scheduler
- salt.states.ddns
  - Dynamic DNS updates
- salt.states.debconfmod
  - Management of debconf selections
- salt.states.disk
- salt.states.dockerio
  - Manage Docker containers
- salt.states.eselect
  - Management of Gentoo configuration using eselect
- salt.states.file
  - Operations on regular files, special files, directories, and symlinks
- salt.states.gem
  - Installation of Ruby modules packaged as gems
- salt.states.git
  - Interaction with Git repositories
- salt.states.gnomedesktop
  - Configuration of the GNOME desktop
- salt.states.grains
  - Manage grains on the minion
- salt.states.group
  - Management of user groups
- salt.states.hg
  - Interaction with Mercurial repositories
- salt.states.host
  - Management of addresses and names in hosts file
- salt.states.iptables
  - Management of iptables
- salt.states.keyboard
  - Management of keyboard layouts
- salt.states.keystone
  - Management of Keystone users
- salt.states.kmod
  - Loading and unloading of kernel modules
- salt.states.layman
  - Management of Gentoo Overlays using layman
- salt.states.libvirt
  - Manage libvirt certificates
- salt.states.locale
- salt.states.lvm
  - Management of Linux logical volumes
- salt.states.lvs_server
  - Management of LVS(Linux Virtual Server) Real Server.
- salt.states.lvs_service
  - Management of LVS(Linux Virtual Server) Service.
- salt.states.makeconf
  - Management of Gentoo make.conf
- salt.states.mdadm
  - Managing software RAID with mdadm
- salt.states.memcached
  - States for Management of Memcached Keys
- salt.states.modjk_worker
  - Manage modjk workers
- salt.states.module
  - Execution of Salt modules from within states
- salt.states.mongodb_database
- salt.states.mongodb_user
  - Management of Mongodb users
- salt.states.mount
  - Mounting of filesystems
- salt.states.mysql_database
  - Management of MySQL databases (schemas)
- salt.states.mysql_grants
  - Management of MySQL grants (user permissions)
- salt.states.mysql_user
  - Management of MySQL users
- salt.states.network
  - Configuration of network interfaces
- salt.states.npm
  - Installation of NPM Packages
- salt.states.ntp
  - Management of NTP servers
- salt.states.openstack_config
- salt.states.pagerduty
  - Create an Event in PagerDuty
- salt.states.pecl
  - Installation of PHP Extensions Using pecl
- salt.states.pip_state
  - Installation of Python Packages Using pip
- salt.states.pkg
  - Installation of packages using OS package managers such as yum or apt-get
- salt.states.pkgng
  - Manage package remote repo using FreeBSD pkgng
- salt.states.pkgrepo
  - Management of package repos
- salt.states.portage_config
  - Management of Portage package configuration on Gentoo
- salt.states.ports
- salt.states.postgres_database
  - Management of PostgreSQL databases
- salt.states.postgres_group
  - Management of PostgreSQL groups (roles)
- salt.states.postgres_user
  - Management of PostgreSQL users (roles)
- salt.states.powerpath
  - Powerpath configuration support
- salt.states.process
  - Process Management
- salt.states.quota
  - Management of POSIX Quotas
- salt.states.rabbitmq_cluster
  - Manage RabbitMQ Clusters
- salt.states.rabbitmq_plugin
  - Manage RabbitMQ Plugins
- salt.states.rabbitmq_policy
  - Manage RabbitMQ Policies
- salt.states.rabbitmq_user
  - Manage RabbitMQ Users
- salt.states.rabbitmq_vhost
  - Manage RabbitMQ Virtual Hosts
- salt.states.rbenv
  - Managing Ruby installations with rbenv
- salt.states.rdp
- salt.states.reg
- salt.states.rvm
  - Managing Ruby installations and gemsets with Ruby Version Manager (RVM)
- salt.states.saltmod
  - Control the Salt command interface
- salt.states.selinux
  - Management of SELinux rules
- salt.states.service
  - Starting or restarting of services and daemons
- salt.states.ssh_auth
  - Control of entries in SSH authorized_key files
- salt.states.ssh_known_hosts
  - Control of SSH known_hosts entries
- salt.states.stateconf
  - Stateconf System
- salt.states.status
- salt.states.supervisord
  - Interaction with the Supervisor daemon
- salt.states.svn
  - Manage SVN repositories
- salt.states.sysctl
  - Configuration of the Linux kernel using sysctrl
- salt.states.timezone
  - Management of timezones
- salt.states.tomcat
- salt.states.user
  - Management of user accounts
- salt.states.virtualenv
  - Setup of Python virtualenv sandboxes
- salt.states.win_dns_client
- salt.states.win_firewall
- salt.states.win_network
  - Configuration of network interfaces on Windows hosts
- salt.states.win_path
- salt.states.win_servermanager
- salt.states.win_system
  - Management of Windows system information
- salt.states.xmpp
  - Sending Messages over XMPP
- salt.states.zcbuildout
  - Management of zc.buildout
Renderers
- Multiple Renderers
- Composing Renderers
- Writing Renderers
- Examples
Full list of builtin renderer modules
- salt.renderers.jinja
- salt.renderers.json
- salt.renderers.mako
- salt.renderers.py
- salt.renderers.pydsl
- salt.renderers.stateconf
- salt.renderers.wempy
- salt.renderers.yaml
Pillars
Full list of builtin pillar modules
- salt.pillar.cmd_json
- salt.pillar.cmd_yaml
- salt.pillar.cobbler
  - Configuring the Cobbler ext_pillar
  - Module Documentation
- salt.pillar.django_orm
  - Configuring the django_orm ext_pillar
  - Module Documentation
- salt.pillar.git_pillar
- salt.pillar.hiera
- salt.pillar.libvirt
- salt.pillar.mongo
- salt.pillar.pillar_ldap
- salt.pillar.puppet
- salt.pillar.reclass_adapter
- salt.pillar.virtkey
Master Tops
Full list of builtin master tops modules
- salt.tops.cobbler
  - Cobbler Tops
  - Module Documentation
- salt.tops.ext_nodes
  - External Nodes Classifier
- salt.tops.mongo
- salt.tops.reclass_adapter
Salt Runners
- Writing Salt Runners
- Examples
Full list of runner modules
- salt.runners.cache
- salt.runners.doc
- salt.runners.fileserver
- salt.runners.jobs
- salt.runners.launchd
- salt.runners.lxc
- salt.runners.manage
- salt.runners.network
- salt.runners.search
- salt.runners.state
- salt.runners.thin
- salt.runners.virt
- salt.runners.winrepo
Full list of builtin wheel modules
- salt.wheel.config
- salt.wheel.file_roots
- salt.wheel.key
- salt.wheel.pillar_roots
Full list of builtin auth modules
- salt.auth.auto
- salt.auth.keystone
- salt.auth.ldap
- salt.auth.pam
- salt.auth.stormpath_mod
Full list of builtin output modules
- salt.output.grains
- salt.output.highstate
- salt.output.json_out
  - Display return data in JSON format
- salt.output.key
- salt.output.nested
- salt.output.no_out
- salt.output.no_return
- salt.output.overstatestage
- salt.output.pprint_out
- salt.output.raw
- salt.output.txt
- salt.output.virt_query
- salt.output.yaml_out
Full list of Salt Cloud modules
- salt.cloud.clouds.botocore_aws
  - The AWS Cloud Module
- salt.cloud.clouds.cloudstack
  - CloudStack Cloud Module
- salt.cloud.clouds.digital_ocean
  - Digital Ocean Cloud Module
- salt.cloud.clouds.ec2
  - The EC2 Cloud Module
- salt.cloud.clouds.gce
  - Google Compute Engine Module
- salt.cloud.clouds.gogrid
  - GoGrid Cloud Module
- salt.cloud.clouds.ibmsce
  - IBM SCE Cloud Module
- salt.cloud.clouds.joyent
  - Joyent Cloud Module
- salt.cloud.clouds.libcloud_aws
  - The AWS Cloud Module
- salt.cloud.clouds.linode
  - Linode Cloud Module
- salt.cloud.clouds.msazure
  - Azure Cloud Module
- salt.cloud.clouds.nova
  - OpenStack Nova Cloud Module
- salt.cloud.clouds.openstack
  - OpenStack Cloud Module
- salt.cloud.clouds.parallels
  - Parallels Cloud Module
- salt.cloud.clouds.rackspace
  - Rackspace Cloud Module
- salt.cloud.clouds.saltify
  - Saltify Module
- salt.cloud.clouds.softlayer
  - SoftLayer Cloud Module
Python client API
- Calling Salt from shell scripts
- Calling Salt via a REST API
- Calling Salt from a Python application
  - opts
- Salt's Python interface
Peer Communication
- Peer Configuration
- Peer Runner Communication
- Using Peer Communication
Client ACL system
- Permission Issues
Salt Syndic
- Configuring the Syndic
- Running the Syndic
File Server Backends
- Environments
Dynamic Module Distribution
- Sync Via States
- Sync Via the saltutil Module
File Server Configuration
- Environments
- Directory Overlay
- Local File Server
Salt File Server
- The cp Module
- File Server Client API
  - FileClient Class
Full list of builtin fileserver modules
- salt.fileserver.gitfs
- salt.fileserver.hgfs
- salt.fileserver.roots
- salt.fileserver.s3fs
- salt.fileserver.minionfs
Configuration file examples
- Example master configuration file
- Example minion configuration file
Configuring the Salt Master
- Primary Master Configuration
- Master Security Settings
- Master Module Management
  - runner_dirs
  - cython_enable
- Master State System Settings
- Master File Server Settings
- Pillar Configuration
  - pillar_roots
  - ext_pillar
- Syndic Server Settings
- Peer Publish Settings
  - peer
  - peer_run
- Node Groups
- Master Logging Settings
- Include Configuration
  - default_include
  - include
Configuring the Salt Minion
- Minion Primary Configuration
- Minion Module Management
- State Management Settings
- File Directory Settings
- Security Settings
  - open_mode
- Thread Settings
- Minion Logging Settings
- Include Configuration
  - default_include
  - include
- Frozen Build Update Settings
  - update_url
  - update_restart_services
Salt code and internals
- Contents
  - Exceptions
  - salt.exceptions
Network Topology
- Servers
- PUB/SUB
- Return
Windows Software Repository
- Operation
- Usage
- Generate Repo Cache File
- Install Windows Software
- Uninstall Windows Software
- Standalone Minion Salt Windows Repo Module
- Git Hosted Repo
- Troubleshooting
Command Line Reference
- Using the Salt Command
salt
- Synopsis
- Description
- Options
- See also
salt-master
- Synopsis
- Description
- Options
  - Logging Options
- See also
salt-minion
- Synopsis
- Description
- Options
  - Logging Options
- See also
salt-key
- Synopsis
- Description
- Options
- See also
salt-cp
- Synopsis
- Description
- Options
  - Logging Options
  - Target Selection
- See also
salt-call
- Synopsis
- Description
- Options
  - Logging Options
  - Output Options
- See also
salt-run
- Synopsis
- Description
- Options
  - Logging Options
- See also
salt-ssh
- Synopsis
- Description
- Options
- See also
salt-syndic
- Synopsis
- Description
- Options
  - Logging Options
- See also
salt-cloud
- Synopsis
- Description
- Options
- Examples
- See also
Release notes and upgrade instructions
- Salt 2014.1.13 Release Notes
- Salt 2014.1.12 Release Notes
- Salt 2014.1.11 Release Notes
- Salt 2014.1.10 Release Notes
- Salt 2014.1.9 Release Notes
- Salt 2014.1.8 Release Notes
- Salt 2014.1.7 Release Notes
- Salt 2014.1.6 Release Notes
- Salt 2014.1.5 Release Notes
- Salt 2014.1.4 Release Notes
- Salt 2014.1.2 Release Notes
- Salt 2014.1.2 Release Notes
- Salt 2014.1.1 Release Notes
- Salt 2014.1.0 Release Notes - Codename Hydrogen
  - Major Features
- Salt 0.17.5 Release Notes
- Salt 0.17.4 Release Notes
- Salt 0.17.3 Release Notes
- Salt 0.17.2 Release Notes
- Salt 0.17.1 Release Notes
  - SSH Enhancements
  - Security Updates
  - Fix Reference
- Salt 0.17.0 Release Notes
  - Major Features
- Salt 0.16.4 Release Notes
- Salt 0.16.3 Release Notes
- Salt 0.16.2 Release Notes
  - Windows
  - Grains
  - Pillar
  - Peer Publishing
  - Minion
  - User/Group Management
  - File Management
  - Package/Repository Management
  - Service Management
  - Networking
  - SSH
  - pip
  - MySQL
  - PostgreSQL
  - Miscellaneous
- Salt 0.16.1 Release Notes
- Salt 0.16.0 Release Notes
  - Major Features
- Salt 0.15.3 Release Notes
- Salt 0.15.2 Release Notes
- Salt 0.15.1 Release Notes
  - Security Updates
- Salt 0.15.0 Release Notes
  - Major Features
- Salt 0.14.1 Release Notes
- Salt 0.14.0 Release Notes
  - Major Features
- Salt 0.13.3 Release Notes
- Salt 0.13.2 Release Notes
- Salt 0.13.1 Release Notes
- Salt 0.13.0 Release Notes
  - Major Features
  - Noteworthy Changes
- Salt 0.12.1 Release Notes
- Salt 0.12.0 Release Notes
  - Major Features
- Salt 0.11.1 Release Notes
- Salt 0.11.0 Release Notes
  - Major Features
  - Notable Changes
- Salt 0.10.5 Release Notes
  - Major Features
  - Noteworthy Changes
- Salt 0.10.4 Release Notes
  - Major Features
  - Security
- Salt 0.10.3 Release Notes
  - Major Features
  - Security Fix
- Salt 0.10.2 Release Notes
  - Major Features
  - Test Updates
  - Many Fixes
- Salt 0.10.1 Release Notes
- Salt 0.10.0 Release Notes
  - Major Features
  - State Call Data Files
  - Turning Off the Job Cache
  - Test Updates
  - Many Fixes
- Salt 0.9.9 Release Notes
  - Major Features
  - New Tests
- Salt 0.9.8 Release Notes
  - Upgrade Considerations
  - Major Features
  - In Progress Development
- Salt 0.9.7 Release Notes
  - Major Features
- Salt 0.9.6 Release Notes
  - New Features
- Salt 0.9.5 Release Notes
  - Community
  - Major Features
  - Packaging Updates
  - Refinement
- Salt 0.9.4 Release Notes
  - Download!
  - New Features
- Salt 0.9.3 Release Notes
  - Download!
  - New Features
  - Module and State Additions
- Salt 0.9.2 Release Notes
  - Download!
  - New Features
  - Notable Bug Fixes
- Salt 0.9.1 Release Notes
- Salt 0.9.0 Release Notes
  - Download!
  - New Features
  - New Modules
- Salt 0.8.9 Release Notes
  - Download!
  - New Features
  - New Modules
- Salt 0.8.8 release notes
- Salt 0.8.7 release notes
- Salt 0.8.0 release notes
  - Salt-cp -
  - Cython minion modules -
  - Dynamic Returners -
  - Configurable Minion Modules -
  - Advanced Minion Threading:
- Salt 0.7.0 release notes
- Salt 0.6.0 release notes

Current Salt release: 2014.1.7

Docs for previous releases on salt.rtfd.org.

Next topic

Frequently Asked Questions

Upcoming SaltStack Events

My conferences on Lanyrd

Salt Table of Contents¶

Next topic

Quick search

Upcoming SaltStack Events