Install in air-gapped environments

The Salt Project provides public repositories for packages on the public Broadcom Artifactory endpoint:

• Salt Project RPM Repo

• Salt Project DEB Repo

• Salt Project Generic Repo (Windows, MacOS, etc.)

The preferred method for installing Salt is using distribution packages. This method ensures that:

• All dependencies are met.

• Salt is installed in a tested and distribution-aligned way.

Note

Salt is often distributed in split packages, but only the salt-master and salt-minion packages are required for Salt to function. If only desiring to run Salt in a masterless setup, then only salt-minion is required.

About air-gapped installations

To install Salt in an air-gapped environment, you can create a local mirror of the Salt Project repositories using a sync tool such as rclone or wget.

Create a local mirror with rclone (faster)

Note

Only sync once per day.

To set up local mirrors with rclone:

Linux (RPM)

Syncs down the following repo: saltproject-rpm

1. In the rclone command line, adapt this example:

   RCLONE_WEBDAV_URL=https://packages.broadcom.com/artifactory/ RCLONE_WEBDAV_VENDOR=other rclone sync --fast-list --use-server-modtime -v :webdav:saltproject-rpm/ ./saltproject-rpm/
   

2. (Optional): If you can’t use the --use-server-modtime flag because your version of rclone is too old, you can use the -c flag instead:

   RCLONE_WEBDAV_URL=https://packages.broadcom.com/artifactory/ RCLONE_WEBDAV_VENDOR=other rclone sync --fast-list -c -v :webdav:saltproject-rpm/ ./saltproject-rpm/
   

Linux (DEB)

Syncs down the following repo: saltproject-deb

1. In the rclone command line, adapt this example:

   RCLONE_WEBDAV_URL=https://packages.broadcom.com/artifactory/ RCLONE_WEBDAV_VENDOR=other rclone sync --fast-list --use-server-modtime -v :webdav:saltproject-deb/ ./saltproject-deb/
   

2. (Optional): If you can’t use the --use-server-modtime flag because your version of rclone is too old, you can use the -c flag instead:

   RCLONE_WEBDAV_URL=https://packages.broadcom.com/artifactory/ RCLONE_WEBDAV_VENDOR=other rclone sync --fast-list -c -v :webdav:saltproject-deb/ ./saltproject-deb/
   

Generic (Windows, macOS, etc.)

Syncs down the following repo: saltproject-generic

1. In the rclone command line, adapt this example:

   RCLONE_WEBDAV_URL=https://packages.broadcom.com/artifactory/ RCLONE_WEBDAV_VENDOR=other rclone sync --fast-list --use-server-modtime -v :webdav:saltproject-generic/ ./saltproject-generic/
   

2. (Optional): If you can’t use the --use-server-modtime flag because your version of rclone is too old, you can use the -c flag instead:

   RCLONE_WEBDAV_URL=https://packages.broadcom.com/artifactory/ RCLONE_WEBDAV_VENDOR=other rclone sync --fast-list -c -v :webdav:saltproject-generic/ ./saltproject-generic/
   

Create a local mirror with wget (slower)

Note

Only sync once per day.

To set up local mirrors with wget:

Linux (RPM)

Syncs down the following repo: saltproject-rpm

In the wget command line, adapt this example:

wget --mirror -nH --cut-dirs=1 https://packages.broadcom.com/artifactory/saltproject-rpm/

Linux (DEB)

Syncs down the following repo: saltproject-deb

In the wget command line, adapt this example:

wget --mirror -nH --cut-dirs=1 https://packages.broadcom.com/artifactory/saltproject-deb/

Generic (Windows, macOS, etc.)

Syncs down the following repo: saltproject-generic

In the wget command line, adapt this example:

wget --mirror -nH --cut-dirs=1 https://packages.broadcom.com/artifactory/saltproject-generic/