# Additional Tips and Troubleshooting

### Install WSL on Windows 

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

1. Open **Start** on Windows 
2. Search for **Command Prompt**, right-click the top result, and select the **Run as administrator** option.
3.  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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-old.zus.network/guides/setup-a-blockchain/additional-tips-and-troubleshooting-for-mac.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.