X-Git-Url: https://git.p6c8.net/policy-templates.git/blobdiff_plain/53fcf1ccc32356d7cb3b3100493abcf5cdf27d1b..b2b92cdcfbb0ce28514a0fd9d35f472bf7c5e530:/mac/README.md diff --git a/mac/README.md b/mac/README.md index 9fa0ac1..ca56ca6 100644 --- a/mac/README.md +++ b/mac/README.md @@ -1,6 +1,4 @@ -**IMPORTANT**: These files are in active development along with the policies in Firefox. To get the policy information that corresponds to a specific release, go to https://github.com/mozilla/policy-templates/releases. - -Starting with Firefox 64 and Firefox ESR 60.4, Firefox supports configuration files on macOS. +**IMPORTANT**: To use enterprise policies on macOS, you must set the `EnterprisePoliciesEnabled` policy. An example plist file with all options is available here: @@ -9,7 +7,7 @@ https://github.com/mozilla/policy-templates/blob/master/mac/org.mozilla.firefox. If you want to set specific options from the command line, we also provide flattened shortcuts to any item that is nested in the plist file. For example, this policy: -``` +```json { "policies": { "Homepage": { @@ -19,14 +17,14 @@ For example, this policy: } ``` which would be set in the plist file like this: +```xml +Homepage + + URL + http://example.com + ``` - Homepage - - URL - http://example.com - -``` -As correctly writing nested values with the `defaults` command can be hard, Firefox also supports writing nested values by separating them with `__`, like this: +Correctly writing the nested value with the `defaults` command can be hard, so you can flatten the keys by separating them with `__`, like this: ```bash sudo defaults write /Library/Preferences/org.mozilla.firefox Homepage__URL -string "http://example.com" ``` @@ -34,3 +32,8 @@ Before any command line policies will work, you need to enable policies like thi ```bash sudo defaults write /Library/Preferences/org.mozilla.firefox EnterprisePoliciesEnabled -bool TRUE ``` +If you want to set user specific policies, use ~/Library without sudo: +```bash +defaults write ~/Library/Preferences/org.mozilla.firefox EnterprisePoliciesEnabled -bool TRUE +defaults write ~/Library/Preferences/org.mozilla.firefox Homepage__URL -string "http://example.com" +```