Skip to content

Commit 2730b1e

Browse files
Added instructions on how to deal with MacOS security measures (docker#12837)
* Added instructions on how to deal with MacOS security measures Mac OS prevents downloaded files to be executed. Added the description how to allow it again. * Minor style updates Co-authored-by: Usha Mandya <[email protected]>
1 parent eb6ed28 commit 2730b1e

File tree

1 file changed

+20
-2
lines changed

1 file changed

+20
-2
lines changed

Diff for: engine/install/binaries.md

+20-2
Original file line numberDiff line numberDiff line change
@@ -136,15 +136,33 @@ The macOS binary includes the Docker client only. It does not include the
136136
$ tar xzvf /path/to/<FILE>.tar.gz
137137
```
138138

139-
3. **Optional**: Move the binary to a directory on your executable path, such
139+
3. Clear the extended attributes to allow it run.
140+
141+
In case executing `docker/docker` you get the error message: *'docker' is*
142+
*damaged and cannot be opened. You should move it to the bin.*
143+
144+
Apple takes care about our security. Hence, we need to remove the security
145+
mechanism preventing us running the executable.
146+
147+
```console
148+
$ sudo xattr -rc docker
149+
```
150+
151+
Now, when you run the following command, you can see the Docker CLI usage instructions:
152+
153+
```console
154+
$ docker/docker
155+
```
156+
157+
4. **Optional**: Move the binary to a directory on your executable path, such
140158
as `/usr/local/bin/`. If you skip this step, you must provide the path to the
141159
executable when you invoke `docker` or `dockerd` commands.
142160

143161
```console
144162
$ sudo cp docker/docker /usr/local/bin/
145163
```
146164

147-
4. Verify that Docker is installed correctly by running the `hello-world`
165+
5. Verify that Docker is installed correctly by running the `hello-world`
148166
image. The value of `<hostname>` is a hostname or IP address running the
149167
Docker daemon and accessible to the client.
150168

0 commit comments

Comments
 (0)