Job Submission

You can submit jobs from within Houdini by installing the integrated submission script, or you can submit them from the Monitor. The instructions for installing the integrated submission script can be found further down this page.

To submit from within Houdini, select ‘Render’ -> ‘Submit To Deadline’.

integrated monitor

Submission Options

The general Deadline options are explained in the Job Submission documentation, and the Draft/Integration options are explained in the Draft and Integration documentation. The Houdini specific options are:

  • ROP To Render:

    • Choose: Allows you to choose your ROP from the dropbox to the right.
    • Selected: Allows you to render each ROP that you currently have selected in Houdini (in the order that you selected)
    • All: Allows you to render every ROP in the Houdini file.
  • Ignore Inputs: If enabled, only the selected ROP will be rendered. No dependencies will rendered.

  • Build to Force: Force 32 or 64 bit rendering.

  • Submit Wedges as Separate Jobs: If enabled, each Wedge in a Wedge ROP will be submitted as a separate job with the current Wedge settings. This option is only enabled if the selected ROP is a Wedge ROP, or if all ROPs are being rendered and at least one of them is a Wedge ROP.

Tile Rendering Options

Enable Tile Rendering to split up a single frame into multiple tiles.

  • Enable Tile Rendering: If enabled, the frame will be split into multiple tiles that are rendered individually and can be assembled after.
  • Tiles In X: Number of horizontal tiles.
  • Tiles In Y: Number of vertical tiles.
  • Single Frame Tile Job Enabled: Enable to submit all tiles in a single job.
  • Single Job Frame: The frame that will be split up.
  • Submit Dependent Assembly Job: Submit a job dependent on the tile job that will assemble the tiles.
  • Cleanup Tiles after Assembly: If selected the tiles will be deleted after assembly.
  • Error on Missing Tiles: If enabled, then if any of the tiles are missing the assembly job will fail.
  • Assemble Over: Determine what the Draft Tile Assembler should assemble over be it a blank image, previous output or a specified file.
  • Error on Missing Background: If enabled, then if the background file is missing the job will fail.

IFD Exporting and Mantra Standalone

The Houdini submitter allows you to submit a job that will export the scene to IFD files, and then submit a dependent Mantra Standalone job to render the exported IFD files.

integrated2 monitor2

When submitting from the Monitor, you just need to enable the Override Export IFD option. When submitting from within Houdini using the integrated submission script, you must first make sure that the ROPs you wish to export have the Disk File option enabled in their properties, and then enable the Submit Dependent Mantra Standalone Job option in the submitter. Note that if a ROP does not have the Disk File setting enabled, it will simply render the image, and no dependent Mantra Standalone job will be submitted.


The general Deadline options for the Mantra Standalone job are explained in the Job Submission documentation. The Mantra Standalone specific options are:

  • Mantra Threads: The number of threads to use for the Mantra stanadlone job.

Plug-in Configuration

You can configure the Houdini plug-in settings from the Monitor. While in super user mode, select Tools -> Configure Plugins and select the Houdini plug-in from the list on the left.


Render Executables

  • Hython Executable: The path to the hython executable. It can be found in the Houdini bin folder. Enter alternative paths on separate lines. Different executable paths can be configured for each version installed on your render nodes.

Licensing Options

  • Slaves To Use Escape License: A list of slaves that should use a Houdini Escape license instead of a Batch license. Use a , to separate multiple slave names, for example: slave001,slave002,slave003

Path Mapping (For Mixed Farms)

  • Enable Path Mapping: If enabled, Deadline will use Houdini’s HOUDINI_PATHMAP environment variable to perform path mappings on the contents of the Houdini scene file. This feature can be turned off if there are no Path Mapping entries defined in the Repository Options.

Integrated Submission Script Setup

The following procedures describe how to setup the integrated Houdini submission script for Deadline. This script has been tested with Houdini 9 and later.

Submitter Installer

ManualInstallation of the Submission Script

On Windows or Linux, copy the client script to the Houdini install directory

  • If the folder [Houdini Install Directory]\houdini\scripts\deadline\ doesn’t exist, create it.
  • Copy [Repository]\submission\Houdini\Client\DeadlineHoudiniClient.py to [Houdini Install Directory]\houdini\scripts\deadline\DeadlineHoudiniClient.py

On Mac OSX, copy the client script to the Houdini Framework folder

  • If the folder [Houdini Framework]/Versions/[Houdini Version]/Resources/houdini/scripts/deadline/ doesn’t exist, create it.
  • Copy [Repository]\submission\Houdini\Client\DeadlineHoudiniClient.py to [Houdini Framework]/Versions/[Houdini Version]/Resources/houdini/scripts/deadline/DeadlineHoudiniClient.py
  • The Houdini Framework folder can typically be found in /Library/Frameworks/Houdini.Framework

Add a menu item to execute the script

  • Open the file [Houdini Install Directory]/houdini/MainMenuCommon in a text editor.

  • Add the following in between the <mainMenu> and </mainMenu> tags, and make sure it is added after the </menuBar> closing tag.

    <addScriptItem id="h.deadline">
    <label>Submit To Deadline</label>

For example, this is what the last few lines of your MainMenuCommon file might look like:


<addScriptItem id="h.deadline">
<label>Submit To Deadline</label>



Which versions of Houdini are supported by Deadline?

Houdini 9 and later are supported. To render with Houdini 7 or 8, use the Mantra Plug-in.

Which Houdini license(s) are required to render with Deadline?

Deadline uses Hython to render, which uses hbatch licenses. If those are not available, it will try to use a Master License instead.

Error Messages and Meanings

This is a collection of known Houdini 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 plug-in.