> For the complete documentation index, see [llms.txt](https://docs.check.tech/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.check.tech/deployment/chrome-edge-deployment-instructions/macos.md).
# macOS
We recommend deploying Check through your MDM if the goal is to install it automatically without user interaction.
A custom `.mobileconfig` file can be uploaded to most MDMs if they don't have built-in profile-building functionality for Google Chrome or Microsoft Edge.
Here's an example XML profile for a mobile configuration that installs Check in Microsoft Edge and Google Chrome.
```
PayloadContent
ExtensionInstallForcelist
benimdeioplgkhanklclahllklceahbe
PayloadDisplayName
Google Chrome
PayloadIdentifier
com.google.Chrome.23E5DDCF-1EB2-4869-9510-5E47D6640A85
PayloadType
com.google.Chrome
PayloadUUID
23E5DDCF-1EB2-4869-9510-5E47D6640A85
PayloadVersion
1
ExtensionInstallForcelist
knepjpocdagponkonnbggpcnhnaikajg
PayloadDisplayName
Microsoft Edge
PayloadIdentifier
com.microsoft.Edge.DD4A940A-B216-4D5E-8B2C-1EF2CAFF7F38
PayloadType
com.microsoft.Edge
PayloadUUID
DD4A940A-B216-4D5E-8B2C-1EF2CAFF7F38
PayloadVersion
1
PayloadDescription
This profile installs and enforces the 'Check' browser extension from CyberDrain on Google Chrome and Microsoft Edge web browsers.
PayloadDisplayName
Check CyberDrain
PayloadIdentifier
020D4Z7P-7F1A-4723-89CB-1826F8BAF4B5
PayloadOrganization
YOUR ORG NAME
PayloadScope
System
PayloadType
Configuration
PayloadUUID
020D4Z7P-7F1A-4723-89CB-1826F8BAF4B5
PayloadVersion
1
RemovalDate
2044-05-19T21:46:44Z
TargetDeviceType
5
```
You could also deploy it in Chrome from the command line by creating the appropriate JSON object in the correct location under the core `/Library` directory in macOS. Credit goes to @cezaraugusto for the script, which was slightly modified to install Check when no parameter is passed. You can also pass another Chrome extension ID after the script path to install that extension.
```
#!/bin/bash
# https://developer.chrome.com/docs/extensions/mv3/external_extensions/#preferences
# Credit to #cezaraugusto# from GitHub Gist for this script, slightly modified to install Check by CyberDrain if no parameter is passed
# https://gist.github.com/cezaraugusto
# https://gist.github.com/cezaraugusto/0101d2cb251c088f398ca0f8d4495ca0
extension=$1
if [[ -z "$extension" ]]; then
extension="benimdeioplgkhanklclahllklceahbe"
fi
install_chrome_extension() {
chrome_extensions_folder="/Library/Application Support/Google/Chrome/External Extensions"
chrome_extensions_preferences_file="$chrome_extensions_folder/$extension.json"
# This URL is used by Chrome to check for updates to external extensions
update_services_url="https://clients2.google.com/service/update2/crx"
if [[ -d "$chrome_extensions_folder" ]]; then
mkdir -p "$chrome_extensions_folder"
fi
echo "{" > "$chrome_extensions_preferences_file"
echo " \"external_update_url\": \"$update_services_url\"" >> "$chrome_extensions_preferences_file"
echo "}" >> "$chrome_extensions_preferences_file"
echo "Added \"$chrome_extensions_preferences_file\""
}
if [ $# -ne 1 ]; then
echo "Usage: $0 "
exit 1
fi
install_chrome_extension "$extension"
# Usage:
# ./install_extension.sh
# Sample: adding React Dev Tools from the command line to Chrome
# ./install_extension.sh fmkadmapgofadopljbjfkapdkoienihi
```
This does not install the extension until the next time Chrome is launched. The user will then be required to approve it.
Due to limitations like this, it is better to deploy the extension through an MDM.
If you have experience deploying managed macOS browser extensions, please contribute to the [docs via GitHub](/readme.md). All macOS resources in the GitHub repo should be considered inaccurate until tested.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.check.tech/deployment/chrome-edge-deployment-instructions/macos.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.