--- title: "Appliance customizations" slug: "appliance-customizations-v7-0" description: "Enable appliance customization scripts securely for AppGate ZTNA. Learn about script limits, management, and configuration for optimal deployment." tags: ["Appliances", "Appliance Customization"] updated: 2026-06-05T19:17:37Z published: 2026-06-05T19:17:37Z canonical: "support.appgate.com/appliance-customizations-v7-0" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.appgate.com/llms.txt > Use this file to discover all available pages before exploring further. # Appliance customizations 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](/v1/docs/clone-configuring-the-first-controller) or when you generate the [seed file](/v1/docs/activating-an-appliance-v7-0#exporting-the-seed-fileiso). > [!NOTE] > 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](/v1/docs/adding-third-party-executables-v7-0). - You must enable customization scripts for the appliance before use. You can enable them [using cz-config](/v1/docs/cz-setup-and-cz-config-commands-v7-0). --- ## 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. ![List of appliances showing their version details as customized.](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/ag63-customize.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A49%3A43Z&se=2026-11-21T22%3A49%3A43Z&sr=b&sp=r&sig=4SdPOKxE14iLa%2BcXfXUVZpTduP3QzOIlry7P8dmnjqU%3D) Click the appliance **Status** to open the detailed view, which shows the specific customization in use. --- ## Configuring appliance customizations To configure a customization: 1. Go to **Appliance Customizations** (System > Appliance Customizations) and click **+Add**. 2. 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](/v1/docs/adding-third-party-executables-v7-0). 3. Save the customization. --- ## Running the customization script After you upload a script, select it in the appliance settings in the [Miscellaneous](/v1/docs/adding-a-new-appliance-v7-0#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 (![Three circular shapes stacked vertically on a dark background, selected to access a menu.](https://cdn.us.document360.io/e7482ce5-acfa-4c3b-b76c-b6c32472644a/Images/Documentation/three_dots.png?sv=2026-02-06&spr=https&st=2026-11-21T21%3A49%3A43Z&se=2026-11-21T22%3A49%3A43Z&sr=b&sp=r&sig=gDxXRpb0R8AY8FwwbjeWjgcDt2picw%2Bb0b01ZqMFFrI%3D)) to the right of each line item—to access the following option: - ***Download Customization***. Downloads the .zip archive for the customization.