macOS

This page provides download files and instructions for installing Salt on macOS.

macOS downloads

Arch	File type	Download install file	GPG
x86_64	pkg	https://repo.saltproject.io/salt/py3/macos/latest/salt-3007.0-py3-x86_64.pkg	https://repo.saltproject.io/salt/py3/macos/SALT-PROJECT-GPG-PUBKEY-2023.gpg
arm64	pkg	https://repo.saltproject.io/salt/py3/macos/latest/salt-3007.0-py3-arm64.pkg	https://repo.saltproject.io/salt/py3/macos/SALT-PROJECT-GPG-PUBKEY-2023.gpg

Before you start

Before installing Salt on your operating system, ensure that you first:

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

Install Salt on macOS

1. Download the Salt installation file for macOS. See macOS downloads for a list of the latest downloads.

   Warning

   OS X Gatekeeper settings may prevent installation of the Salt package. If a warning appears during installation, open System Preferences > Security & Privacy and click Open Anyway.

2. Run the file to install Salt.

3. After installation, configure the Salt minion ID, and the Salt master location, replacing the placeholder text with custom information:

   sudo salt-config -i yourminionname -m yoursaltmaster
   

   Tip

   See Configure the Salt master and minions for more configuration options.

4. Start the minion service. The commands to start and stop services are different for macOS than other operating systems.

   To start the minion service:

   sudo launchctl start com.saltstack.salt.minion
   

   To stop the minion service:

   sudo launchctl stop com.saltstack.salt.minion
   

After installing Salt on macOS, you need to complete the following post-installation steps:

• Accept the minion keys
• Verify a Salt install

Browse the repo

Browse the repo for macOS packages

macOS 3007.0