summaryrefslogtreecommitdiff
path: root/AltOS/MacOSX.mdwn
diff options
context:
space:
mode:
authorBdale Garbee <bdale@gag.com>2017-12-21 19:51:21 -0700
committerBdale Garbee <bdale@gag.com>2017-12-21 19:51:21 -0700
commit6d8bedf01f189ddff4cc99d0fbfcbd1d75f07a46 (patch)
treed194952a2d0af9015d9053748def42b42529aea1 /AltOS/MacOSX.mdwn
parente28ff195f95038471b14a8d1dc641b65ea365f5a (diff)
parent91b98393bfeee7dbf64b68ef3432ca26ae3be97e (diff)
Merge branch 'master' of ssh://git.gag.com/scm/git/web/altusmetrum
Diffstat (limited to 'AltOS/MacOSX.mdwn')
-rw-r--r--AltOS/MacOSX.mdwn34
1 files changed, 34 insertions, 0 deletions
diff --git a/AltOS/MacOSX.mdwn b/AltOS/MacOSX.mdwn
new file mode 100644
index 0000000..2933f28
--- /dev/null
+++ b/AltOS/MacOSX.mdwn
@@ -0,0 +1,34 @@
+# Installing AltosUI on Mac OS X
+
+Mac OS X places barriers to running software from outside of the Apple
+ecosystem on Apple hardware. Whenever you download softwarae, the
+browser tags the application as 'foreign' and that prevents the
+operating system from running it.
+
+Here's how you can use xattr(1) to clear the protection setting from
+the AltosUI.app after it is installed.
+
+1. Display the application extended attributes:
+
+ $ xattr -l /Applications/AltosUI.app
+ com.apple.quarantine:
+ 0181;5a380dfb;Google\x20Chrome.app;6B17C3F9-68D3-4C27-A5EA-7ADADE376ACD
+
+ This shows that the app was downloaded using google chrome. Other
+ users' values will be different but the com.apple.quarantine
+ prefix will be the same!). If this attribute is present
+ AltosUI.app won't be allowed to run.
+
+1. Use the following command to remove the attribute preventing MacOS
+ X from running this application:
+
+ $ sudo xattr -c /Applications/AltosUI.app
+
+ This clears the extended attribute in question. You should now be
+ able to run our app!
+
+1. Check to make sure the attribute has been cleared:
+
+ $ xattr -l /Applications/AltosUI.app
+
+NOTE: this has to be run every time one installs a new version!