> For the complete documentation index, see [llms.txt](https://docs-old.zus.network/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-old.zus.network/guides/setup-a-blockchain/additional-tips-and-troubleshooting-for-mac.md).

# Additional Tips and Troubleshooting

### Install WSL on Windows&#x20;

To install WSL (Windows Subsystem for Linux) from Command Prompt, use these steps:&#x20;

1. Open **Start** on Windows&#x20;
2. Search for **Command Prompt**, right-click the top result, and select the **Run as administrator** option.
3. &#x20;Type the following command to install the WSL on Windows and press **Enter**:

   ```
   wsl --install
   ```

<figure><img src="/files/1MBu56iMWcX9bbFltpHj" alt=""><figcaption><p>WSL Install on Ubuntu</p></figcaption></figure>

4\. Restart your computer to finish the WSL installation on Windows.

5\. Once you complete the steps, the latest version of the Ubuntu Linux distribution will be installed.\
\
6\. Now to start the Linux at any time on windows open the command prompt again and type:

```
wsl
```

<figure><img src="/files/JK9YISdTP8rB7lG5C0K4" alt=""><figcaption><p>WSL Run</p></figcaption></figure>

### Install Homebrew and mockery on Mac and Linux

#### &#x20;1. Run Homebrew installation script

Here is the command, just run it-

```
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

#### 2. Add Homebrew to your PATH

To run the brew command after installation, we need to add it to our system path…

```
eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"
```

Note: This step is not required for mac.

#### 3. Check Brew is working fine

To ensure everything is working correctly to use brew, we can run its command-

```
brew doctor
```

Sample Response:

```
Your system is ready to brew.
```

#### 4. Now install mockery&#x20;

```
brew install mockery
```

or for Apple Silicon

```
arch -arm64 brew install mockery
```

Sample Response when retrieving mockery version should be similar to this:

```
mockery --version
24 Nov 22 03:53 IST INF Starting mockery dry-run=false version=v2.15.0
v2.15.0
```

**Note: At the time of installation the latest mockery version is 2.15.0.**&#x20;

### Windows Dependencies for Zbox and ZwalletCLI&#x20;

1. Install git bash for windows. Instructions can be found [here](https://git-scm.com/download/win).
2. Install TDM-GCC for Windows from [here](https://github.com/jmeubank/tdm-gcc/releases/download/v10.3.0-tdm64-2/tdm64-gcc-10.3.0-2.exe).
3. Open `git bash`**and** follow steps from [building zbox](/guides/zbox-cli/get-started.md#building-zbox) or [zwallet](/guides/zwallet-cli/get-started.md#building-zwallet).

### Additional Mac Troubleshooting

These are additional tips for Mac in case you cannot get the setup running.

* Provide at least 5GB or more RAM to Docker.
* Increase Docker Swap to 3GB or more.
* Download the appropriate go binary from [here ](https://go.dev/dl/)(arm or intel) for [building zbox](#step-5-register-a-wallet-using-zboxcli) .
* Update Docker to the latest version.
* Run the script below as sudo to overcome the mac docker network issue before[ registering a wallet](#step-5-register-a-wallet-using-zboxcli).

{% file src="/files/Tc9MIJYMfpxpPQeJJcJa" %}

### Troubleshooting Guide for Blobbers Setup (Mac M1 or M2)

If blobbers and validators containers are not coming up while doing local setup, then you can try these steps:

* You can try removing `wallet.json` file from `~/.zcn` directory and recreate a wallet by using `./zwallet create-wallet` command. Copy the `client_id` generated from here and paste in `delegate_wallet: <your_new_client_id>` in `0chain_blobber.yaml` and `0chain_validatory.yaml` files present at `blobber/config` directory.
* Also, check if `block_worker` is set to `http://198.18.0.98:9091/` in both of the above files.
* Stop the `sharders` and `miners` containers and restart them. First start the `sharder` and when it is ready (try hitting the `localhost:7171` to test) then start the miner.
* Now start the blobbers and validators.
* If you are on Mac M1. You need to start blobbers and validators by running the `cli.sh` script from [this folder](https://github.com/0chain/blobber/blob/staging/dev.local/cli.sh). This is an interactive script. When you run it, you need to provide input for what you need to do. Follow these:
  1. Create a postgres db by pressing `1` and then again `1`.
  2. Create a blobber by running the script again and press `1` and then `2`.
  3. If the step2 works, start a new terminal window and run the script again, and press `1` and then `3` to start the validator.&#x20;
  4. Repeat steps 2 and 3 to start multiple blobbers and validators by following the interactive cmd line.