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

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:


Install Homebrew and mockery on Mac and Linux

1. Run Homebrew installation script

Here is the command, just run it-

/bin/bash -c "$(curl -fsSL"

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

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

Note: At the time of installation the latest mockery version is 2.15.0.

Windows Dependencies for Zbox and ZwalletCLI

  1. Install git bash for windows. Instructions can be found here.

  2. Install TDM-GCC for Windows from here.

  3. Open git bashand follow steps from building zbox or 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 (arm or intel) for building zbox .

  • Update Docker to the latest version.

  • Run the script below as sudo to overcome the mac docker network issue before registering a wallet.

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 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 script from this folder. 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.

    4. Repeat steps 2 and 3 to start multiple blobbers and validators by following the interactive cmd line.

Last updated