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 ```
  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 ```
  23         <key>Homepage</key>
  24         <dict>
  25                 <key>URL</key>
  26                 <string>http://example.com</string>
  27     </dict>
  28 ```
  29 can be set via the command line like this:
  30 ```
  31 defaults write 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 ```
  35 defaults write org.mozilla.firefox EnterprisePoliciesEnabled -bool TRUE
  36 ```