Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added instructions to fix Docker error on Mac #982

Closed
wants to merge 1 commit into from
Closed

Added instructions to fix Docker error on Mac #982

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 19 additions & 0 deletions main/guides/getting-started/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,7 @@ As you're going through this tutorial it may be helpful to watch this video walk

Currently Agoric supports macOS and Linux (including [Windows Subsystem for Linux](https://learn.microsoft.com/en-us/windows/wsl/about)). This tutorial is based on an installation of [Ubuntu 22.04 LTS](https://ubuntu.com/download/desktop). If you're using a different operating system, some variation may be required.


## Installing Prerequisites

In this section you'll be installing prerequisite components into your environment. If you're working with your own environment rather than using a fresh Ubuntu install, you may already have some or all of these components already installed.
Expand Down Expand Up @@ -159,6 +160,24 @@ For more examples and ideas, visit:

</details>

::: tip Using a Mac?
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe include "troubleshooting" in the tip line?

Also, my habit is to take error messages and put them into search boxes / search engines, and I think I'm not alone; so let's put the text of these diagnostics in the body of this box so that folks who search for them will find this box:


If you're using a Apple Mac with a Apple Silicon processor you will need to enable gRPC Fuse and disable Virtualization Framework in Docker desktop. To accomplish this first open Docker Desktop. Once open, click on the gear icon in the top right hand corner of the application to open Docker Desktop settings.

![Open Docker Desktop settings](./assets/docker_001.png)


Next, select the option for gRPC Fuse. Once selected you should then be able to uncheck the box labeled "Use Virtualization framework".

![Change virtualization settings](./assets/docker_002.png)


Finally click the "Apply & restart" button to apply your changes.

![Apply new virtualization settings](./assets/docker_003.png)

:::

## Creating Your Dapp From a Template

Now you'll use yarn to pull down the sample dapp. The sample dapp will be placed in a subfolder named `demo`.
Expand Down
Loading