Deployment

Force-install Osprey on managed browsers with the templates below, covering Group Policy, Intune, macOS, Linux, and Firefox.

Managing an organization? Use the Osprey Management Console instead.

Enroll devices with a script, push policies to every browser from one place, and get dashboards, alerts, and white-labeled reports across every client. The templates below then only need to force-install the extension; the console handles everything else.


See plans and pricing

Choose your platform

Every template embeds the same hardened example configuration. Edit the placeholder domains and identifiers before you push.

  • Windows, Group Policy

    Import the administrative template for a full settings UI in gpedit and GPMC, covering every policy for Chrome and Edge. The .reg files are for a quick test without Group Policy.

    Osprey.admxOsprey.adml (en-US)Chrome.regEdge.regFirefox.reg

  • Windows, Microsoft Intune

    Import the ADMX above into Intune for a full settings UI, then force-install through the Settings Catalog. The guide walks through both, with an OMA-URI fallback.

    Intune guide

  • macOS

    Deploy the matching configuration profile through your MDM. Each profile sets every key and force-installs the extension. The plist is for MDMs that take a custom plist instead.

    Chrome profileEdge profileChrome plist

  • Linux

    Copy the file for your browser to the managed-policy directory in its name. For example, the Chrome file goes to /etc/opt/chrome/policies/managed/osprey.json.

    Chrome JSONChromium JSONEdge JSON

  • Firefox

    Firefox does not read Chromium managed storage. Deploy the native managed-storage manifest, or the enterprise policies.json with its 3rdparty.Extensions block and force-install.

    Managed-storage manifestpolicies.json


Download all templates

Extension IDs

The extension has a different ID in each store. Use the right one for each browser family.

StoreExtension id
Chrome Web Store (Chrome, Chromium, Brave, Vivaldi)jmnpibhfpmpfjhhkmpadlbgjnbhpjgnd
Microsoft Edge Add-onsnopglhplnghfhpniofkcopmhbjdonlgn
Firefox Add-ons (AMO)osprey@foulest.net

Where each browser reads settings

Chromium browsers share the managed-storage model but each vendor uses its own path. On Windows the full key adds \3rdparty\extensions\<id>\policy. Getting the path wrong is the most common reason a deployment applies on some browsers and not others.

BrowserWindows registry rootmacOS preference domainLinux managed directory
ChromeHKLM\SOFTWARE\Policies\Google\Chromecom.google.Chrome/etc/opt/chrome/policies/managed/
ChromiumHKLM\SOFTWARE\Policies\Chromiumorg.chromium.Chromium/etc/chromium/policies/managed/
EdgeHKLM\SOFTWARE\Policies\Microsoft\Edgecom.microsoft.Edge/etc/opt/edge/policies/managed/
BraveHKLM\SOFTWARE\Policies\BraveSoftware\Bravecom.brave.Browser/etc/brave/policies/managed/
VivaldiHKLM\SOFTWARE\Policies\Vivaldicom.vivaldi.Vivaldi/etc/vivaldi/policies/managed/

Firefox does not read Chromium managed storage. It uses a native manifest namedosprey@foulest.net.json, or a 3rdparty.Extensions block inpolicies.json. Prefer the native manifest for lists and objects, because Firefox delivers those as strings when they are set through the Windows registry. The full guide lists every path.

Removal protection

None of these templates stop a user from removing the extension. That is a browser force-install policy, separate from Osprey's settings, set with ExtensionInstallForcelist on Chromium browsers and ExtensionSettings on Firefox. The macOS profiles already include it.

Documentation

Full deployment guideRemoval protection note

Something not working?

Send us a message or create an issue on GitHub.
We'll get back to you as soon as we can.