How do I setup an HQueue server and client (Windows)?

The HQueue server does not require a license to operate.

The HQueue clients do require licenses to run Houdini jobs. Houdini simulation jobs and IFD generation jobs require Houdini Engine (or equivalent, i.e. Houdini FX) licenses. Mantra render jobs require Render licenses. Karma render jobs require Karma licenses. All other render jobs that cook .hip files require Houdini Engine (or equivalent) licenses.

HQueue server configuration

Create a new user for the renderfarm

Create a new user that will be common on all nodes in your render farm, including the HQueue server. Or, use an existing user account that is already on every machine on the farm (server and clients).

Right-click on the Windows start icon and select Computer Management.

Windows Key


Select Local Users and Groups

Windows Keyr


Right-click on Users to select New User. Fill in the new user details. There is an example below you may follow.

Windows Keyr


Right-click on Groups to select New Group. Fill in the new group information. There is an example below you may follow.

Windows Keyr


Now you will create a new user and group for the farm. Both the server machine and client nodes should use the same user. You will also use this user to map the shared network drive exported by the server.

In this example, we will create the hquser and the hqgroup. We will put the hquser into the hqgroup. Assign the hquser a password. The render farm will use hquser and hqgroup to map the network drive and to run the HQueue server/client software.

Create hquser

Ensure to add hquser to the hqgroup. If you're using a different user/group, ensure to add your user to the group you have created.

Create hqgroup

Create the shared network folder and export to the client nodes

The render nodes will access this mapped network drive using the render farm username and password as given in the previous steps. In this example, this will be hquser.

In this example, we have created the hq folder in the C: drive.

Right-click on the hq folder and select Properties.
Click on the Sharing tab.
Next, click the Share button.

Create network folder 1


Find the new user you have created (in this example it is hquser) and click Add. Ensure this user has Read/Write access to the network share.

Network folder user access


The network folder is now configured. Remote client machines should now be able to use the shared drive as the hquser. Your machine name will be different than our example. Your user name to access the shared folder may also be different if you have used something other than hquser.

Share network folder


Install the HQueue Server software using the Houdini installer

Using the Houdini installer on your server machine, select to install the HQueue server. If you want the HQueue server to also act as a client, go ahead and install the HQueue client as well along with the main Houdini application. If you are installing the HQueue client, you will need to ensure that the Houdini application is also selected to be installed.

In this example, the HQueue server will be called brock.sidefx.com. Your machine name will be different. Please use your machine name in place of brock.sidefx.com.

Server setup 1

Server setup 2

Server setup 3

The HQueue server should be now accessible through a web browser: http://localhost:5000

In this example we have two clients configured - one being the server machine itself. It is also a client node.

HQueue web server

Remote clients will need to access the HQueue server either by the machine name or the routable address. In our example, the license server is Brock so to access HQueue over the web browser: http://brock.sidefx.com:5000. Substitute Brock.sidefx.com with your server machine name or address. Ensure to add :5000 as this is the port clients will connect to.

HQueue client configuration

Create the new render farm user on the client node

Just like you had done on the server machine:
Create a new user that will be common on all nodes in your render farm, including the HQueue server. Or, use an existing user account that is already on every machine on the farm (server and clients).

Right-click on the Windows start icon and select Computer Management.

Windows Key


Select Local Users and Groups

Windows Keyr


Right-click on Users to select New User. Fill in the new user details. There is an example below you may follow.

Windows Keyr


Right-click on Groups to select New Group. Fill in the new group information. There is an example below you may follow.

Windows Keyr


Now you will create a new user and group for the farm. Both the server machine and client nodes should use the same user. You will also use this user to map the shared network drive exported by the server.

In this example, we will create the hquser and the hqgroup. We will put the hquser into the hqgroup. Assign the hquser a password. The render farm will use hquser and hqgroup to map the network drive and to run the HQueue server/client software.

Create hquser

Ensure to add hquser to the hqgroup. If you're using a different user/group, ensure to add your user to the group you have created.

Create hqgroup

Map the shared network drive

Map the network share created on the server, onto the client machine. Use the render user you have setup to connect to the share.

In the following example, we will map the network drive as the common hquser user.


Right-click the Windows Start button and select File Explorer.

File Explorer

Click the Map network drive button at the top.

This PC

Another way to view the Map Network Drive functionality is to right-click on This PC.
This PC 2


Map network drive


Map network drive 2

Install the HQueue client software using the Houdini installer

Install HQueue client 1

Install HQueue client 2

Install HQueue client 3
Enter the name of the HQueue server. Ensure to use your machine name or IP address.
In our example, brock.sidefx.com is the HQueue server.
Install HQueue client 4

For more information on HQueue please refer to the online documentation