## Deploy extension to your organization URL: https://docs.atlan.com/product/integrations/automation/browser-extension/how-tos/configure-the-extension-for-managed-browsers > Learn how to deploy the Atlan browser extension across your organization using managed browsers and MDM software on macOS and Windows. # Deploy extension to your organization You can deploy the Atlan browser extension across your entire organization using your existing mobile device management (MDM) software. This installs and configures the extension automatically for all users—no manual setup required on each device. This guide covers macOS and Windows devices, and supports both Google Chrome and Microsoft Edge. ## Prerequisites Before you begin, make sure you have: - The **Admin** role in Atlan to configure the extension and download the deployment script. - Administrator access to your organization's MDM software (for example, Microsoft Intune) to deploy policies to all users. ## Configure extension in Atlan In your Atlan workspace, generate the configuration script to deploy to your users' devices. 1. In your Atlan workspace, click **Settings** from the left menu. If you are using the **Old UI (Classic)**, from the left menu, click **Admin**. 2. Click **Integrations**. 3. Under _Apps_, expand the **Browser extension** tile and click **Set up now**. 4. In the _Set up browser extension_ form, select your browser and operating system. The values are prefilled based on your current setup, update them if needed. 5. For _Your Atlan domain_, enter the URL of your Atlan instance, for example: ``` https://mycompany.atlan.com ``` 6. (Optional) Under _Advanced settings_, configure the following as needed: - **Multiple Atlan domains**: if your organization has more than one Atlan instance, toggle this on and add the additional URLs. Users see a dropdown to select the relevant instance. - **Custom data source domains**: if your data tools are hosted on custom domains rather than their standard SaaS URLs, toggle this on and add each tool and its domain. Users can't update or remove these, but can add additional custom domains. 7. Click **Download Script** to download the configuration file. Based on your operating system, this is either a `.mobileconfig` file (macOS) or a `.ps1` PowerShell script (Windows). ## Force-install extension Configure the `ExtensionInstallForcelist` browser policy in your MDM software to silently install the extension for all users when they log in. Follow the steps in the Google documentation: [Force install apps and extensions](https://support.google.com/chrome/a/answer/6306504?hl=en). Follow the steps in the Microsoft documentation: [Force-install an extension](https://learn.microsoft.com/en-us/deployedge/microsoft-edge-manage-extensions-policies#force-install-an-extension). For the _Extension/App IDs and update URLs to be silently installed_ field, use the following value: ``` fipjfjlalpnbejlmmpfnmlkadjgaaheg;https://clients2.google.com/service/update2/crx ``` - `fipjfjlalpnbejlmmpfnmlkadjgaaheg` is the extension ID for the Atlan browser extension. - `https://clients2.google.com/service/update2/crx` specifies that it's installed from the Chrome Web Store. ## Deploy configuration script Deploy the script downloaded in the previous step using your MDM software to configure the extension domains for all users. In your MDM console, create a new custom configuration profile and upload the `.mobileconfig` file downloaded from Atlan. For example, in Microsoft Intune: 1. In the Intune admin center, go to **Devices → macOS → Configuration profiles**. 2. Click **Create → New policy** and select **Templates → Custom** as the profile type. 3. Upload the `.mobileconfig` file and give the profile a name. 4. Under **Assignments**, select the device groups to deploy to and click **Save**. For other MDM platforms, see [Custom configuration profile settings](https://learn.microsoft.com/en-us/intune/intune-service/configuration/custom-settings-macos#custom-configuration-profile-settings). In your MDM console, create a new PowerShell script policy and upload the `.ps1` file downloaded from Atlan. For example, in Microsoft Intune: 1. In the Intune admin center, go to **Devices → Windows → Scripts and remediations**. 2. Click **Add** and upload the `.ps1` configuration script downloaded from Atlan. 3. Under **Script settings**, configure the following: - _Run this script using the logged on credentials_: set to **No**. - _Enforce script signature check_: set to **No**. - _Run script in 64-bit PowerShell Host_: set to **Yes**. 4. Under **Assignments**, select the device groups to deploy to and click **Save**. For other MDM platforms, see [Create a script policy and assign it](https://learn.microsoft.com/en-us/mem/intune/apps/intune-management-extension#create-a-script-policy-and-assign-it). ## Verify installation After deploying the policies, confirm the extension is working correctly before rolling out broadly. 1. On a target device, check that the Atlan browser extension is installed and the configured domains are applied. 2. In your MDM platform, monitor the compliance status of the policy and resolve any issues flagged. Once the managed browser syncs with the latest configuration, the extension is automatically installed and a new tab opens to confirm it's active. ## Configure custom domains for your organization :::warning Who can do this? You need the **Admin** role in Atlan to configure custom domains for your organization. ::: If your data tools are hosted on custom domains rather than their standard SaaS URLs, you can set these org-wide so all users see them preloaded in their extension. 1. In your Atlan workspace, click **Settings** from the left menu. If you are using the **Old UI (Classic)**, from the left menu, click **Admin**. 2. Click **Integrations**. 3. Under _Apps_, expand the **Browser extension** tile. 4. Under _Set up your custom data source_, click **Configure**. 5. For _Connector_, select a supported tool, then enter the custom domain URL for that tool. 6. Click **+ Add** to add more tools as needed, then click **Save**. Users in your workspace see these domains preloaded in their extension. They can add custom domains for additional tools, but can't update or remove the ones you've configured. ## Need help? If you have any issues while deploying the extension, contact [**Atlan Support**](https://docs.atlan.com/support/submit-request) for assistance. ## See also - [Install and set up browser extension](https://docs.atlan.com/llms/governance/integrations/install-and-set-up-the-browser-extension/llms.txt) - [Use Atlan browser extension](https://docs.atlan.com/llms/governance/integrations/use-the-atlan-browser-extension/llms.txt) - [Atlan browser extension security](https://docs.atlan.com/llms/governance/integrations/security/llms.txt) ---