Important: Before you can configure webhooks, you will need to create an admin user for the license server (sesinetd).

Please refer to How do I add the admin user to the license server?

Checklist

• Install a full copy of Houdini to the server.

• Install a database backend. By default, SideFX webhooks creates a database using MySQL.

• Next you can install and configure an application to read the tables from the database and graph the results. You can try something like Grafana.

Configuration

• Setup your backend database user and password. By default, the SideFX webhooks will create the sidefx_webhooks database for MySQL.

• Create a user and password with appropriate permissions to the sidefx_webhooks database and tables.

• Edit the file $HFS/houdini/help/licensing/webhook/webhook_server.py where $HFS is the installation path of Houdini.

• Copy the Signing Secret given by the License Administrator>Webhooks tab and copy it to the SIGNING_SECRET variable in the file $HFS/houdini/help/licensing/webhook/webhook_server.py. If you regenerate the signing secret in the License Administrator, you will need to copy it to the webhook_server.py file.

• Edit the $HFS/houdini/help/licensing/webhook/webhook_server.py and ensure the python library matches your Houdini installation:

sys.path.append(os.path.expandvars("$HFS/houdini/python3.11libs/"))

• Start the webhook using your database user and password:

python3.11  $HFS/houdini/help/licensing/webhook/webhook_server.py licenseadmin password

• Edit the URL in the License Administrator's Webhook tab:

http://yourserver.domain.com:8080/sidefx.webhook

• Once there is data populated in the database tables, you can setup another package to display the data, such as Grafana.

For more information, please refer to the documentation.