macOS Manual Deployment

macOS Manual Deployment

This guide explains how to manually install Lumia on macOS machines to enable inspection and governance of AI traffic on the endpoint.
Use the Lumia macOS installer (PKG file) to deploy the Lumia configuration to the endpoints you want to monitor. The installer is available for download via the dedicated link provided by Lumia.
Before running the installation file, consider the following:
Permissions
Administrator privileges are required to perform the installation. Lumia will be installed for all users on the machine.
Setting the Endpoint’s Email / Identity
Lumia registers each endpoint to identify which user is associated with it. This identity is used for reporting and to enable direct communication in case of policy violations (e.g., via email or Slack).
  • Automatic Setting: By default, the installer will register the endpoint with the Lumia platform using the Username@HostName convention.
    (Note: Since this is not a valid email address, direct user notifications will not work).
  • Custom Mapping (CSV): To enable direct notifications and clearer user identification, you can provide a mapping between computer names and email addresses using a .csv file. Once provided, Lumia’s onboarding team will incorporate it into your organization’s installer so that the endpoint is registered with the correct email address.
    • ⚠️
    Important: This mapping must be provided to Lumia before you download and run the installer.

Installation Steps

  1. Download the installer from your dedicated link.
    (Note: If you require custom email mapping, ensure you have provided your CSV file to Lumia and received your custom installer).
  2. Double-click the Lumia.pkg file.
  3. Follow the instructions in the installation wizard.
  4. Restart any AI-related applications that were open during the installation (e.g., Web Browsers, Desktop AI apps like ChatGPT or Cursor, or CLI tools). This ensures the new network configuration (PAC) is active, as some applications load proxy definitions only on startup.
  5. Return to our Getting Started guide and proceed to Step 1.2: Verify Integration. Follow the instructions there to confirm that the endpoint is successfully forwarding AI interactions and that logs are appearing in your Lumia Portal.
💡

Uninstallation

To stop Lumia from monitoring the endpoint, run the Lumia_Uninstall.pkg provided by Lumia.
Administrator privileges are required.