Salt (or SaltStack) is a management system that can be used to keep applications and plugins synched across your render nodes. See the SaltStack Website for more information.

The Salt event plugin that ships with Deadline can be used to run a Salt update on a Worker when it starts and when it becomes idle, thus allowing you to keep your render nodes in sync without interrupting jobs that are currently rendering.

Note that Salt must already be configured to work outside of Deadline. Once your Salt system is set up, you can then enable the Salt event plugin for Deadline to automatically trigger Salt updates.


Some configuration is needed to use the Salt event plugin. To access these settings, simply enter Super User mode and select Tools -> Configure Events form the Monitor’s menu. From there, select the Salt entry from the list on the left.


The Salt event plugin settings are:


  • State: There are three different states that an Event Plugin can be in: Global Enabled, Opt-In, and Disabled. In order for this feature to function properly, the State must be set to either Global Enabled or Opt-In. Note that if this plugin is in the Opt-In state, the jobs that want to run this plugin must opt into Salt.

  • Salt Exe: The path to the Salt Executable. Enter alternative paths on separate lines.

  • Logging: The level of verbose logging Salt will provide.


Is Salt supported?


Error Messages and Meanings

This is a collection of known Salt error messages and their meanings, as well as possible solutions. We want to keep this list as up to date as possible, so if you run into an error message that isn’t listed here, please email Deadline Support and let us know.

Currently, no error messages have been reported for this event plug-in.