--- title: "Adding or deleting a custom whitelist rule using the CLI" slug: "adding-or-deleting-a-custom-whitelist-rule-using-the-cli-1" tags: ["Product Usage", "EX 11.x", "FX 11.x", "AX 11.x", "NX 11.x", "Network Security"] updated: 2026-09-12T20:42:33Z published: 2026-09-12T20:42:33Z canonical: "docs.trellix.com/adding-or-deleting-a-custom-whitelist-rule-using-the-cli-1" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Adding or deleting a custom whitelist rule using the CLI Use the CLI commands in this topic to add a rule to a custom whitelist or to delete a rule from a custom whitelist. You can add up to 10,000 whitelist entries to the appliance database. **To add rules to a custom whitelist:** 1. Go to CLI configuration mode. ``` hostname > enable hostname # configure terminal ``` 2. Specify the type of rule to add to a custom whitelist. - To add the whitelist rule based on an eight-digit signature ID: ``` hostname (config) # analysis custom whitelist signature-id ``` - To add the whitelist rule based on the URL: ``` hostname (config) # analysis custom whitelist url ``` - To add the whitelist rule based on the RegEx URL: ``` hostname (config) # analysis custom whitelist regex url ``` - To add the whitelist rule based on the SHA-256 hash file: ``` hostname (config) # analysis custom whitelist sha256 ``` - To add the whitelist rule based on the MD5 hash file: ``` hostname (config) # analysis custom whitelist md5sum ``` 3. Verify that the specified signature ID and SHA-256 hash file are added to the custom whitelist. ``` hostname (config) # show analysis custom whitelist ``` 4. Verify that the specified URLs are added to the custom whitelist. ``` hostname (config) # show analysis custom whitelist urls ``` 5. Verify that the specified RegEx URLs are added to the custom whitelist. ``` hostname (config) # show analysis custom whitelist regex urls ``` 6. Save your changes. ``` hostname (config) # write memory ``` **Examples** This example adds the URL "trackeragain.keymedia.com/?id=124375" to a custom whitelist: ``` hostname (config) # analysis custom whitelist url trackeragain.keymedia.com/?id=124375 hostname (config) # show analysis custom whitelist urls Successfully fetched url whitelist Custom Whitelist URLs:  http://hsych.com/channel-9.html1491201030.73.7242  http://trackeragain.keymedia.com/?id=124375 ``` This example adds the SHA-256 hash file "2ff34afe77d5dd3b92c4d9c6bc1003870580e2d7a51ace181c0fc6fac62bd881" to the whitelist: ``` hostname (config) # analysis custom whitelist sha256 2ff34afe77d5dd3b92c4d9c6bc1003870580e2d7a51ace181c0fc6fac62bd881 ``` This example adds the signature ID "13456789" to the whitelist: ``` hostname (config) # analysis custom whitelist signature-id 13456789 ``` This example shows that the specified SHA-256 hash file and signature ID are added to the custom whitelist: ``` hostname # show analysis custom whitelist Custom Whitelists:  2ff34afe77d5dd3b92c4d9c6bc1003870580e2d7a51ace181c0fc6fac62bd881 Signature ID Whitelist:  13456789 ``` **To delete rules from a custom whitelist:** 1. Go to CLI configuration mode. ``` hostname > enable hostname # configure terminal ``` 2. Specify the type of rule to delete from a custom whitelist. - To delete the whitelist rule based on the URL: ``` hostname (config) # no analysis custom whitelist url ``` - To delete the whitelist rule based on the RegEx URL: ``` hostname (config) # no analysis custom whitelist regex url ``` - To delete the whitelist rule based on the SHA-256 hash file: ``` hostname (config) # no analysis custom whitelist sha256 ``` - To delete the whitelist rule based on the MD5 hash file: ``` hostname (config) # no analysis custom whitelist md5sum ``` - To delete the whitelist rule based on an eight-digit signature ID: ``` hostname (config) # no analysis custom whitelist signature-id ``` 3. Verify that the specified signature ID and SHA-256 hash file are deleted from the custom whitelist. ``` hostname (config) # show analysis custom whitelist ``` 4. Verify that the specified URLs are deleted from the custom whitelist. ``` hostname (config) # show analysis custom whitelist urls ``` 5. Verify that the specified RegEx URLs are deleted from the custom whitelist. ``` hostname (config) # show analysis custom whitelist regex urls ``` 6. Save your changes. ``` hostname (config) # write memory ``` ### Examples This example deletes the URL "trackeragain.keymedia.com/?id=124375" from a custom whitelist: ``` hostname (config) # no analysis custom whitelist url trackeragain.keymedia.com/?id=124375 ``` ``` hostname # show analysis custom whitelist urls Successfully fetched url whitelist Custom Whitelist URLs:  http://hsych.com/channel-9.html1491201030.73.7242 ``` This example confirms that the URL no longer exists: ``` hostname (config) # no analysis custom whitelist url trackeragain.keymedia.com/?id=124375 % Unable to delete: url not found ``` This example deletes the signature ID "13456789" from the whitelist: ``` hostname (config) # no analysis custom whitelist signature-id 13456789 ``` This example deletes the SHA-256 hash file "2ff34afe77d5dd3b92c4d9c6bc1003870580e2d7a51ace181c0fc6fac62bd881" from the whitelist: ``` hostname (config) # no analysis custom whitelist sha256 2ff34afe77d5dd3b92c4d9c6bc1003870580e2d7a51ace181c0fc6fac62bd881 ``` This example shows that the SHA-256 hash file and signature ID are deleted from the custom whitelist: ``` hostname (config) # show analysis custom whitelist No whitelisted signature-ids. ```