Override Options for Mac & Linux

Last Updated: July 07, 2026

Rather than making a change in the Admin Console and affecting all Agents, you can use the following override options to change the Virtual Appliance Agent's functionality on a single device or virtual desktop infrastructure (VDI) image.

Overrides

You can define overrides for Linux in /etc/environment. For example, echo "PL_DISABLE_AD_LOOKUPS=1" | sudo tee -a /etc/environment. To apply an override on macOS, we recommend editing the /Library/LaunchDaemons/com.printerlogic.client.plist file and adding the key and string values using the following format:

Copy Code 
<key>EnvironmentVariables</key>
<dict>
    <key>PL_CONFIG_DIRECTORY</key>
    <string>/opt/pl-config</string>
    
    <key>PL_TRUST_STORE</key>
    <string>0</string>
</dict>

You should only define <key>EnvironmentVariables</key> once in the file. Define additional environment variables using the <dict> element, as shown above.

After you apply a new override, you must restart the Virtual Appliance Agent or the device.

The Agent

Turn Off Active Directory Lookup

By default the Agent looks up current user information from discoverable Active Directory domain controllers that exist in the Domain Name System (DNS). If the macOS or Linux device is not integrated with the Active Directory, you can add an environment variable to prevent the lookup. This variable only applies to macOS, Ubuntu, and Red Hat Agent versions 25.1.0.610 and later.

To turn on this override, create the following entry on the device:

  1. Navigate to /etc/environment, or edit the /Library/LaunchDaemons/com.printerlogic.client.plist file.
  2. Create a key named PL_DISABLE_AD_LOOKUPS.
  3. Set the string value to 1 to turn off Active Directory lookup.
    • Setting the value to 0 turns on Active Directory lookup.

Ignore Certificate Failures

Set this variable for the Agent to ignore certificate-verification failures. This override is helpful in environments with restrictions that conflict with certificate verification.

To turn on this override, create the following entry on the device:

  1. Navigate to /etc/environment, or edit the /Library/LaunchDaemons/com.printerlogic.client.plist file.
  2. Create a key named PL_TRUST_STORE.
  3. Set the string value to 0 to ignore certificate failures.
    • Setting the value to 1 enforces certificate validation.

Proxy Overrides

Set the Proxy Type

This override affects proxy detection. To turn on this override, create the following entry on the device:

  1. Navigate to /etc/environment, or edit the /Library/LaunchDaemons/com.printerlogic.client.plist file.
  2. Create a key named PL_PROXY_TYPE.
  3. Set the string value to the desired option:
    • MANUAL
      • Key: PL_HTTP_PROXY. Value: Proxy address for HTTP traffic.
      • Key: PL_HTTPS_PROXY. Value: Proxy address for HTTPS traffic.
      • Key: PL_PROXY_BYPASS. Value: Fully qualified domain name (FQDN) or IP address wildcard, such as 192.168.*, 10.*, etc., for traffic that should not go through the proxy. This value depends on how you reference printers on the Port tab.
    • PAC
      • Key: PL_PAC_URL. Value: URL of the PAC file.
    • NONE
      • Turns off proxy-server use.

Set the Proxy to HTTP or HTTPS

This override sets the proxy type to HTTP or HTTPS:

  1. Navigate to /etc/environment, or edit the /Library/LaunchDaemons/com.printerlogic.client.plist file.
  2. Create the desired option:
    • http_proxy = <proxy server FQDN or IP address>:<port>.
    • https_proxy = <proxy server FQDN or IP address>:<port>.

The Service Agent

Change the Agent Configuration Files Location

This system variable overrides the location in which the Agent configuration files are stored. This override helps keep files in the same location on devices designated as the Service Agent.

Items are normally stored in the following locations:

  • pl_device_id: /etc/pl_device_id.
  • pl_configuration.json: /opt/PrinterInstallerClient/configuration.json.
  • PrinterLogicServiceManager/token.json: /opt/PrinterInstallerClient/service_client/service-manager/config/token.json.

To turn on this override, create the following entry on the Service Agent device:

  1. Navigate to /etc/environment, or edit the /Library/LaunchDaemons/com.printerlogic.client.plist file.
  2. Create a key named PL_CONFIG_DIRECTORY.
  3. Set the string value to the desired file location. For example, PL_CONFIG_DIRECTORY=/opt/pl-config.

Change the Service Agent Services Files Location

This system variable overrides the location in which the Service Agent services files are stored. This override helps keep files in the same location on devices designated as the Service Agent.

Each Service Agent service that is in use is stored in a subdirectory of the service's name. The following are examples:

  • PrinterLogicServicePrinterApp.
  • PrinterLogicServiceOutputManagement.

To turn on this override, create the following entry on the Service Agent device:

  1. Navigate to /etc/environment, or edit the /Library/LaunchDaemons/com.printerlogic.client.plist file.
  2. Create a key named PL_STORAGE_DIRECTORY.
  3. Set the string value to the desired file location. For example, PL_STORAGE_DIRECTORY=/opt/pl-config.

Set the User Account to Nobody

This override is specific to Ubuntu headless installation and changes the user account running the Agent from root to nobody. This override is helpful when you do not want enabled services running as root on the Service Agent device.

To turn on this override, create the following entry on the Service Agent device:

  1. Navigate to /etc/environment, or edit the /Library/LaunchDaemons/com.printerlogic.client.plist file.
  2. Create a key named PL_RUN_AS.
  3. Set the string value to the desired account, other than root. For example, PL_RUN_AS=nobody.

Xerox Ignore Change Permissions

If you install the Xerox Control Panel Application (CPA) in single sign-on (SSO) provider mode, it changes the app Xerox permissions and adjusts the home screen. This override ignores app-permission changes and sets the home screen to Virtual Appliance.

To turn on this override, create the following entry on the Service Agent device:

  1. Navigate to /etc/environment, or edit the /Library/LaunchDaemons/com.printerlogic.client.plist file.
  2. Create a key named XEROX_IGNORE_CHANGE_PERMISSIONS.
  3. Set the string value to 1.