Skip to content

Commit ce71e60

Browse files
authored
[DOCS] [7.6] Update Apple notarization instructions (elastic#51883)
* [DOCS] [7.6] Update Apple notarization instructions * Changes admonition label * Adds a command for preventing macOS Gatekeeper checks. * Changes the Apple support link for the notarization security overrides.
1 parent 36f582a commit ce71e60

File tree

1 file changed

+29
-13
lines changed

1 file changed

+29
-13
lines changed
Lines changed: 29 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,5 @@
11
==== Running Elasticsearch from the command line
22

3-
[IMPORTANT]
4-
.Unidentified developer warnings
5-
====
6-
Apple's rollout of stricter notarization requirements affected the notarization
7-
of the {version} {es} artifacts. If macOS Catalina displays an unidentified
8-
developer warning when you first run {es}, you will need to add a security
9-
override.
10-
11-
To add a security override, follow the instructions in
12-
https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unidentified-developer-mh40616/mac[Open
13-
a Mac app from an unidentified developer].
14-
====
15-
163
Elasticsearch can be started from the command line as follows:
174

185
[source,sh]
@@ -28,3 +15,32 @@ that supports arrays and assume that Bash is available at `/bin/bash`.
2815
As such, Bash should be available at this path either directly or via a
2916
symbolic link.
3017

18+
[IMPORTANT]
19+
.macOS Gatekeeper warnings
20+
====
21+
Apple's rollout of stricter notarization requirements affected the notarization
22+
of the {version} {es} artifacts. If macOS Catalina displays a dialog when you
23+
first run {es} that interrupts it, you will need to take an action to allow it
24+
to run.
25+
26+
To prevent Gatekeeper checks on the {es} files, run the following command on the
27+
downloaded `.tar.gz` archive or the directory to which was extracted:
28+
29+
[source,sh]
30+
----
31+
xattr -d -r com.apple.quarantine <archive-or-directory>
32+
----
33+
34+
For example, if the `.tar.gz` file was extracted to the default
35+
elasticsearch-{version} directory, the command is:
36+
37+
[source,sh,subs="attributes"]
38+
----
39+
xattr -d -r com.apple.quarantine elasticsearch-{version}
40+
----
41+
42+
Alternatively, you can add a security override for both `jdk.app` and
43+
`controller.app` by following the instructions in the _How to open an app that
44+
hasn’t been notarized or is from an unidentified developer_ section of
45+
https://support.apple.com/en-us/HT202491[Safely open apps on your Mac].
46+
====

0 commit comments

Comments
 (0)