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
  • Before you start

Before you start#

Before you start a Salt installation, check the system requirements to ensure your platform is supported in the latest version of Salt and open the required network ports. Ensure you also have the correct permissions to install packages on the targeted nodes.

  • Check your network ports
  • Check system requirements
  • Check your permissions

previous

Quickstart

next

Check your network ports

Show Source

© Copyright 2022 - 2026, VMware, Inc..

Created using Sphinx 9.1.0.

Built with the PyData Sphinx Theme 0.19.0.