--- title: "Preliminary and background information on Appliance Customizations" slug: "appliance-customizations-v6-7" description: "Enable and configure Appliance Customizations Scripts if required by your enterprise and learn how to manage them effectively. They are disabled by default." updated: 2026-06-02T20:14:02Z published: 2026-06-02T20:14:49Z canonical: "support.appgate.com/appliance-customizations-v6-7" --- > ## 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. It is generally not recommended to run these scripts on appliances in AppGate ZTNA as they can compromise system security, which is why they are disabled by default. However, appliance customization scripts are sometimes required in enterprise deployments. If they are required, the scripts can be enabled when an appliance is created in [cz-setup](/v1/docs/configure-using-cz-setup-v6-7) or when the [seed file](/v1/docs/managing-appliance-defining-a-new-appliance-v6-7#export-seed-fileiso) is generated. ## Before you start Consider the following before configuring appliance customization scripts: - Each appliance can have only one script configured. If two separate functions need to be performed, then the script calls the two sub-functions that should also be included in the script. - There is a limit 200MB for all customizations configured. This is set to limit the amount of data that needs to be synced via BDR. - The .zip file must meet specific requirements set out in the [Adding third party executables](/v1/docs/adding-third-party-executables-v6-7) section. - Customization scripts must be enabled for the appliance.You can enable scripts [using cz-config](/v1/docs/cz-setup-and-cz-config-commands-v6-7). ## Running the customization script Once uploaded, the script can be selected in the appliances' settings in the [Miscellaneous](/v1/docs/miscellaneous-v6-7) tab. Once selected, these will then be under the control of `cz-configd` and will be started, stopped, and monitored the same as all the other running processes. ## Viewing customized appliances If an appliance has a customization selected, this will be shown in the **Appliances** page in the *Version* column. There will be a (c) next to the version number. ![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-10-26T22%3A36%3A41Z&se=2026-10-26T23%3A36%3A41Z&sr=c&sp=r&sig=%2BDLU0KXlJCbXy5s2DNBLEVBr0ySlv8qfyyL6bblhv1w%3D) By clicking on the **Status** of the appliance, the detailed view window will show which specific customization is in use. Use the **Appliance Customizations** page to: - View all the appliance customizations you have configured in the Collective. - Upload new appliance customizations. - Perform actions using the action buttons provided. See the [Configure Appliance Customizations](/v1/docs/configure-appliance-customizations-v6-7) section when you are ready to add a customization. ## Action Buttons Action buttons are accessed by clicking 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-10-26T22%3A36%3A41Z&se=2026-10-26T23%3A36%3A41Z&sr=c&sp=r&sig=%2BDLU0KXlJCbXy5s2DNBLEVBr0ySlv8qfyyL6bblhv1w%3D)) to the right of each line item in the page or from the button within the item. They are contextual, changing depending on the type of item and the state of the item. The Action button in the Appliance Customizations page displays the following option: - ***Download Customization***. Downloads the zip archive for the customization.