Skip to main content
Ctrl+K
Salt install guide - Home Salt install guide - Home
  • Install overview
  • Quickstart
  • Before you start
  • Manual install directions by operating system
  • Bootstrap installation
    • Other installation types
    • Configure the Salt master and minions
    • Start the master and minion services
    • Accept the minion keys
    • Verify a Salt install
    • Install dependencies
    • Uninstall Salt
    • Revert to a previous version of Salt
    • Upgrade Salt
    • Upgrade to onedir
    • Salt supported operating systems
    • Salt version support lifecycle
    • Support for Python versions
    • Access old packages of Salt
    • Announcements
    • Downloads
    • Open a Salt issue to report bugs
    • Open an Install Guide docs issue
    • Salt docs contributing guide
    • Salt Install Guide source
  • Install overview
  • Quickstart
  • Before you start
  • Manual install directions by operating system
  • Bootstrap installation
  • Other installation types
  • Configure the Salt master and minions
  • Start the master and minion services
  • Accept the minion keys
  • Verify a Salt install
  • Install dependencies
  • Uninstall Salt
  • Revert to a previous version of Salt
  • Upgrade Salt
  • Upgrade to onedir
  • Salt supported operating systems
  • Salt version support lifecycle
  • Support for Python versions
  • Access old packages of Salt
  • Announcements
  • Downloads
  • Open a Salt issue to report bugs
  • Open an Install Guide docs issue
  • Salt docs contributing guide
  • Salt Install Guide source

Salt Install Guide

  • Install overview
    • Standard installation overview
    • Alternative installations and configurations
  • Quickstart
    • Who should do the quickstart tutorial?
    • Before you start
    • Install Salt with the quickstart script
    • Install Salt on your infrastructure (Linux only)
    • Write and test your first Salt state
    • Next steps

Install Salt

  • Before you start
    • Check your network ports
    • Check system requirements
    • Check your permissions
  • Manual install directions by operating system
    • Linux (DEB)
    • Linux (RPM)
    • macOS
    • Windows
  • Bootstrap installation
    • About the Salt bootstrap installation
    • Learn more
  • Other installation types
    • Install in air-gapped environments
    • Platform agnostic installation (pip)
    • Install a release candidate

Post-installation

  • Configure the Salt master and minions
    • Basic master configuration
    • Basic minion configuration
    • Additional configuration files
    • Common configuration options
    • For more information
    • Next steps
  • Start the master and minion services
    • Starting Salt services
    • Next steps
  • Accept the minion keys
    • About the Salt key exchange
    • Managing keys
    • Accepting keys
    • Deleting keys
    • Automatically accept or reject keys
    • Reference: salt-key flags
    • Next steps
  • Verify a Salt install
    • Send a test ping
    • Next steps
  • Install dependencies
    • Installing dependencies in onedir versions of Salt
    • List of dependencies by operating system
  • Uninstall Salt
  • Revert to a previous version of Salt
    • Revert Salt on Debian/Ubuntu operating systems
    • Revert Salt on RedHat operating systems

Upgrade Salt

  • Upgrade Salt
    • Upgrade your Salt infrastructure
    • Restart and upgrade minions used in state runs
    • Pin to a release for updates
  • Upgrade to onedir
    • What is onedir?
    • How to upgrade to onedir

Support

  • Salt supported operating systems
    • Overview of supported operating systems
    • Support definitions
    • Full support policy by operating system
    • Reasonable-effort support policy by operating system
  • Salt version support lifecycle
    • Version support lifecycle
    • LTS/STS release and support policy
    • Support level definitions
    • Older version support lifecycle
    • Older version support level definitions
  • Support for Python versions
    • Fully supported
    • Reasonable-effort support
    • Resources
  • Access old packages of Salt
  • Announcements
    • Security announcements
    • Release announcements
  • Downloads
    • Linux (RPM)
    • Linux (DEB)
    • macOS
    • Windows

Contribute

  • Open a Salt issue to report bugs
  • Open an Install Guide docs issue
  • Salt docs contributing guide
  • Salt Install Guide source
  • Other installation types

Other installation types#

The following instructions provide explanations about additional installation scenarios:

  • Install in air-gapped environments
  • Platform agnostic installation (pip)
  • Install a release candidate

previous

Bootstrap installation

next

Install in air-gapped environments
Show Source

© Copyright 2022 - 2026, VMware, Inc..

Created using Sphinx 9.1.0.

Built with the PyData Sphinx Theme 0.18.0.