Appliances can run a script to support third-party add-ons such as external reporting or monitoring agents. These scripts are disabled by default because they can compromise system security. Some enterprise deployments require appliance customization scripts. You can enable scripts when you create an appliance in cz-setup or when you generate the seed file.
NOTE
Running customization scripts on appliances in AppGate ZTNA poses security risks. Enable them only when your deployment requires it.
Consider the following before you configure appliance customization scripts:
Each appliance supports only one script. If you need two functions, write a single script that calls both as sub-functions.
All customizations have a combined size limit of 200 MB. This limit controls the amount of data synced through BDR.
The .zip file must meet the requirements described in Adding third-party executables.
You must enable customization scripts for the appliance before use. You can enable them using cz-config.
Viewing customized appliances
If an appliance has a customization selected, the Appliances page shows a (c) next to the version number in the Version column.

Click the appliance Status to open the detailed view, which shows the specific customization in use.
Configuring appliance customizations
To configure a customization:
Go to Appliance Customizations (System > Appliance Customizations) and click +Add.
Then complete the following fields:
Name. Enter a name for the appliance customization.
Notes. Optional. Enter notes for the customization.
Tags. Select +Add to add tags to the customization.
Script File. Upload a .zip file containing the script to execute on the appliance. The .zip file must meet the requirements described in Adding third-party executables.
Save the customization.
Running the customization script
After you upload a script, select it in the appliance settings in the Miscellaneous tab. Once selected, cz-configd controls the script and starts, stops, and monitors it the same way it manages all other running processes.
Managing appliance customizations
Use the action button—the three dots icon (
) to the right of each line item—to access the following option:
Download Customization. Downloads the .zip archive for the customization.