X-Git-Url: https://git.p6c8.net/policy-templates.git/blobdiff_plain/4cc86996596b69ddd055786d44e4d13d662c8883..bc50c50a9808bcb2d4e32259c43cf7cda953e2cd:/mac/README.md
diff --git a/mac/README.md b/mac/README.md
index 5b575da..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,18 +17,23 @@ 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
-
-```
-can be set via the command line like this:
-```
-defaults write org.mozilla.firefox Homepage__URL -string "http://example.com"
+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"
```
Before any command line policies will work, you need to enable policies like this:
+```bash
+sudo defaults write /Library/Preferences/org.mozilla.firefox EnterprisePoliciesEnabled -bool TRUE
```
-defaults write 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"
```