Skip to content

Commit

Permalink
Merge pull request #74 from docker/cli-install-in-wsl2
Browse files Browse the repository at this point in the history
Add WSL2 instructions for CLI install
  • Loading branch information
gtardif authored Jan 28, 2022
2 parents cc18c9b + ff856d2 commit 775538a
Show file tree
Hide file tree
Showing 3 changed files with 52 additions and 17 deletions.
4 changes: 4 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,10 @@ This repository includes Desktop Extension samples.

:warning: **This work is experimental and still in progress, features and APIs detailed are subject to change**

## Documentation

The documentation is published and best viewed at https://docker-desktop-extensions.netlify.app/.

## Prerequisites

To get started with Docker Extensions you will need a specific Docker Desktop build that comes with extension capabilities and the Extensions CLI.
Expand Down
61 changes: 45 additions & 16 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,25 +27,54 @@ Go to the [releases page](https://github.com/docker/desktop-extension-samples/re

Once you've downloaded Extensions CLI, you need to extract the binary into `~/.docker/cli-plugins`.

For macOS:
=== ":fontawesome-brands-apple: MacOS (intel)"

```console
tar -xvzf desktop-extension-cli-darwin-amd64.tar.gz
chmod +x docker-extension
mkdir -p ~/.docker/cli-plugins
mv docker-extension ~/.docker/cli-plugins
```
In a terminal, run:

!!! info
```console
tar -xvzf desktop-extension-cli-darwin-amd64.tar.gz
chmod +x docker-extension
mkdir -p ~/.docker/cli-plugins
mv docker-extension ~/.docker/cli-plugins
```

When running the Extensions CLI on macOS you'll see the message: _"docker-extension" cannot be opened because the developer cannot be verified."_ At the moment, the Extensions CLI is not signed by Docker (yet) and you'll need to trust the binary by going to `System Preferences` > `Security & Privacy` > (General tab) click on `Allow Anyway`.
!!! info

For Windows:
When running the Extensions CLI on macOS you'll see the message: _"docker-extension" cannot be opened because the developer cannot be verified."_ At the moment, the Extensions CLI is not signed by Docker (yet) and you'll need to trust the binary by going to `System Preferences` > `Security & Privacy` > (General tab) click on `Allow Anyway`.

```console
tar -xvzf desktop-extension-cli-windows-amd64.tar.gz
mkdir -p ~/.docker/cli-plugins
mv docker-extension.exe ~/.docker/cli-plugins
```
=== ":fontawesome-brands-apple: MacOS (arm)"

You can now enable the extension feature by running `docker extension enable`
In a terminal, run:

```console
tar -xvzf desktop-extension-cli-darwin-arm64.tar.gz
chmod +x docker-extension
mkdir -p ~/.docker/cli-plugins
mv docker-extension ~/.docker/cli-plugins
```

!!! info

When running the Extensions CLI on macOS you'll see the message: _"docker-extension" cannot be opened because the developer cannot be verified."_ At the moment, the Extensions CLI is not signed by Docker (yet) and you'll need to trust the binary by going to `System Preferences` > `Security & Privacy` > (General tab) click on `Allow Anyway`.

=== ":fontawesome-brands-windows: Windows"

In a PowerShell terminal, run:

```powershell
tar -xvzf desktop-extension-cli-windows-amd64.tar.gz
mkdir -p ~/.docker/cli-plugins
mv docker-extension.exe ~/.docker/cli-plugins
```

=== ":fontawesome-brands-windows: :fontawesome-brands-linux: WSL2"

In a WSL2 terminal, run:

```console
tar -xvzf desktop-extension-cli-linux-amd64.tar.gz
mkdir -p ~/.docker/cli-plugins
mv docker-extension ~/.docker/cli-plugins
```

You can now enable the extension feature by running `docker extension enable`.
4 changes: 3 additions & 1 deletion mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,7 @@ theme:
- navigation.sections
- toc.integrate
- content.code.annotate
- content.tabs.link
extra:
generator: false
copyright: Copyright © 2021 Docker, Inc.
Expand All @@ -35,7 +36,8 @@ markdown_extensions:
- pymdownx.emoji:
emoji_index: !!python/name:materialx.emoji.twemoji
emoji_generator: !!python/name:materialx.emoji.to_svg

- pymdownx.tabbed:
alternate_style: true
nav:
- Introduction: index.md
- Tutorials:
Expand Down

0 comments on commit 775538a

Please sign in to comment.