mac/README.md

   1 **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.
   2
   3 Starting with Firefox 64 and Firefox ESR 60.4, Firefox supports configuration files on macOS.
   4
   5 An example plist file with all options is available here:
   6
   7 https://github.com/mozilla/policy-templates/blob/master/mac/org.mozilla.firefox.plist
   8
   9 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.
  10
  11 For example, this policy:
  12 ```json
  13 {
  14   "policies": {
  15     "Homepage": {
  16       "URL": "http://example.com/"
  17     }
  18   }
  19 }
  20 ```
  21 which would be set in the plist file like this:
  22 ```xml
  23 <key>Homepage</key>
  24 <dict>
  25   <key>URL</key>
  26   <string>http://example.com</string>
  27 </dict>
  28 ```
  29 Correctly writing the nested value with the `defaults` command can be hard, so you can flatten the keys by separating them with `__`, like this:
  30 ```bash
  31 sudo defaults write /Library/Preferences/org.mozilla.firefox Homepage__URL -string "http://example.com"
  32 ```
  33 Before any command line policies will work, you need to enable policies like this:
  34 ```bash
  35 sudo defaults write /Library/Preferences/org.mozilla.firefox EnterprisePoliciesEnabled -bool TRUE
  36 ```
  37 If you want to set user specific policies, use ~/Library without sudo:
  38 ```bash
  39 defaults write ~/Library/Preferences/org.mozilla.firefox EnterprisePoliciesEnabled -bool TRUE
  40 defaults write ~/Library/Preferences/org.mozilla.firefox Homepage__URL -string "http://example.com"
  41 ```