Getting Started

This section covers how to install and configure blobber. In order to use blobber functionality, you will need to join the Züs network with the following prerequisites:
Storage : Required Free Space: 5 GB for blobber files and additional free storage space for renting it on  Züs network.
RAM: 4GB Minimum
CPU: 4 Core CPU 
OS: Linux (Ubuntu Preferred) Version: 20.04 and Above
       Mac(Apple Silicon or Intel) Version: Big Sur and Above
       Windows(Requires WSL ) Version: Windows 11 or 10 version 2004 and above
Required Software dependencies
Installing and running blobber requires deployment-specific dependencies to be preinstalled
Docker
Docker is available for Linux, macOS and Windows platforms. Find instructions for the preferred operating system here.
Clone the Blobber Repository
After installing Docker and Docker Compose:
1.Clone the Blobber repository using the command
git clone https://github.com/0chain/blobber.git
2. Navigate into blobber directory
cd blobber
3. Inside blobber directory, run the commands below .The first command makes the shell script executable and while the next ones execute the shell script to create blobber directories.
chmod +x ./docker.local/bin/blobber.init.setup.sh
./docker.local/bin/blobber.init.setup.sh
NOTE: For Mac :
chmod +x ./docker.local/bin/blobber.init.setup-mac.sh
./docker.local/bin/blobber.init.setup-mac.sh
Create and Configure Containers for Blobbers
To create containers for blobbers and allow interaction between them. You need to create a network using docker which connects them with each other.
1.To set up a network, specify the network name(testnet0),subnet and gateway by using the below command.
docker network create --driver=bridge --subnet=198.18.0.0/15 --gateway=198.18.0.255 testnet0
2. Set up the block_worker URL
A block worker URL is a field in the blobber/config/0chain_validator.yaml    and0chain_blobber.yamlconfiguration files that require the URL of network you want to connect to.
Since we are connecting to the network, we will replace the default URL in blobber/config/0chain_validator.yaml and0chain_blobber.yaml with the below-mentioned URL.
block_worker: http://demo.zus.network/dns
3. Navigate to the config directory using
cd blobber/config
You will see blobber and validation files listed
4. Use the nano editor to edit the block_worker field for both files using the command :
nano 0chain_blobber.yaml
and
nano 0chain_validator.yaml
Note: Step 5 and 6 is an optional step and only required when you are setting up blobber on cloud computing instances. In case of a local blobber setup leave them as it is.

5. Navigate back to the blobber directory and modify the b0bnode1_keys.txt located in thedocker.local/keys_config by replacing localhost with public IP of your cloud VM/ instance.
nano /docker.local/keys_config/b0bnode1_keys.txt
Sample Screenshot:
6. In the b0docker-compose.yml file located in thedocker.local directory, edit the command field in the blobber section, the command field will look like this :
Here replace the localhost with < public ip here > of instance /VM IP
Build Blobbers
1.Now go back to the blobber directory and build containers using the below command
./docker.local/bin/build.base.sh
./docker.local/bin/build.blobber.sh
./docker.local/bin/build.validator.sh
This would take few minutes to set up install dependencies.
Register a Wallet using zboxcli
1.Now clone the zbox CLI repository using the command
git clone https://github.com/0chain/zboxcli.git
2.Install the zboxcli dependencies
Go
Go installation instructions for different operating systems can be found here . Once dependencies are installed navigate into zboxcli directory using
cd zboxcli
3. Use the make install command to compile the source code.
make install
This might take couple of minutes. Sample output after successful compiling:
4.Now connect the Zbox to the 0Chain network Configuration for the 0Chain network by default is stored in network/one.yaml file which we will copy to a new config.yaml file.
     The config.yaml file and all the other Zbox component information will be stored in a new zcn             folder located in home directory of file system.
4. Make a new zcn folder in home linux directory using
mkdir $HOME/.zcn
.zcn is used to denote a hidden folder.
5. Copy the content from one.yaml to a new config.yaml file using
cp network/one.yaml $HOME/.zcn/config.yaml
To verify whether the config.yaml exist and network configuration is stored properly. From the home directory navigate to zcn folder . You will see config.yaml listed.
6. Check the config file configuration using
nano config.yaml
---
block_worker: https://dev.0chain.net/dns
signature_scheme: bls0chain
min_submit: 50
min_confirmation: 50
confirmation_chain_length: 3
max_txn_query: 5
query_sleep_time: 5
# # OPTIONAL - Uncomment to use/ Add more if you want
# preferred_blobbers:
#   - http://one.devnet-0chain.net:31051
#   - http://one.devnet-0chain.net:31052
#   - http://one.devnet-0chain.net:31053
According to the config mentioned in block worker field of your file, zbox will connect to desired 0Chain network by default this would be https://one.devnet-0chain.net/` lets change it to http://beta.0chain.net/0dns .
7. Check whether Zbox is running by navigating back to zboxcli directory
cd zboxcli
and type
./zbox
On a successful run you will see a help section like this:
zbox is a decentralized storage application written on the 0Chain platform.
            Complete documentation is available at https://docs.0chain.net/0chain/
​
Usage:
  zbox [command]
​
Available Commands:
  add-collab        add collaborator for a file
  alloc-cancel      Cancel an allocation
  alloc-fini        Finalize an expired allocation
  bl-info           Get blobber info
  bl-update         Update blobber settings by its delegate_wallet owner
  commit            commit a file changes to chain 
  copy              copy an object(file/folder) to another folder on blobbers
  cp-info           Challenge pool information.
  delete            delete file from blobbers
  delete-collab     delete collaborator for a file
  download          download file from blobbers
  get               Gets the allocation info
  get-diff          Get difference of local and allocation root
  get-download-cost Get downloading cost
  get-upload-cost   Get uploading cost
  getwallet         Get wallet information
  help              Help about any command
  list              list files from blobbers
  list-all          list all files from blobbers
  listallocations   List allocations for the client
  ls-blobbers       Show active blobbers in storage SC.
  meta              get meta data of files from blobbers
  move              move an object(file/folder) to another folder on blobbers
  newallocation     Creates a new allocation
  register          Registers the wallet with the blockchain
  rename            rename an object(file/folder) on blobbers
  rp-create         Create read pool if missing
  rp-info           Read pool information.
  rp-lock           Lock some tokens in read pool.
  rp-unlock         Unlock some expired tokens in a read pool.
  sc-config         Show storage SC configuration.
  share             share files from blobbers
  sign-data         Sign given data
  sp-info           Stake pool information.
  sp-lock           Lock tokens lacking in stake pool.
  sp-pay-interests  Pay interests not payed yet.
  sp-unlock         Unlock tokens in stake pool.
  sp-user-info      Stake pool information for a user.
  start-repair      start repair file to blobbers
  stats             stats for file from blobbers
  sync              Sync files to/from blobbers
  update            update file to blobbers
  update-attributes update object attributes on blobbers
  updateallocation  Updates allocation's expiry and size
  upload            upload file to blobbers
  version           Prints version information
  wp-info           Write pool information.
  wp-lock           Lock some tokens in write pool.
  wp-unlock         Unlock some expired tokens in a write pool.
​
Flags:
      --config string              config file (default is config.yaml)
      --configDir string           configuration directory (default is $HOME/.zcn)
  -h, --help                       help for zbox
      --network string             network file to overwrite the network details (if required, default is network.yaml)
      --silent                     Do not show interactive sdk logs (shown by default)
      --wallet string              wallet file (default is wallet.json)
      --wallet_client_id string    wallet client_id
      --wallet_client_key string   wallet client_key
​
Use "zbox [command] --help" for more information about a command.
8. To register a wallet on Zbox to be used both by the blockchain and blobbers. Use the following Zbox command
 ./zbox register
Successful Response:
Wallet Registered
By default, the wallet information will be stored in wallet.json located in the .zcn folder of the Linux home directory.

9. Navigate back to the .zcn folder
cd $HOME/.zcn/
10. Open the wallet.json file. It should be similar to the similar to the output below:
{"client_id":"4af719e1fdb6244159f17922382f162387bae3708250cab6bc1c20cd85fb594c",
"client_key":"da1769bd0203b9c84dc19846ed94155b58d1ffeb3bbe35d38db5bf2fddf5a91c91b22bc7c89dd87e1f1fecbb17ef0db93517dd3886a64274997ea46824d2c119",
"keys":[{"public_key":"da1769bd0203b9c84dc19846ed94155b58d1ffeb3bbe35d38db5bf2fddf5a91c91b22bc7c89dd87e1f1fecbb17ef0db93517dd3886a64274997ea46824d2c1>
"private_key":"542f6be49108f52203ce75222601397aad32e554451371581ba0eca56b093d19"}],
"mnemonics":"butter whisper wheat hope duck mention bird half wedding aim good regret maximum illegal much inch immune unlock resource congress drift>
"version":"1.0","date_created":"2021-09-09T20:22:56+05:30"}
11. Copy the client_id value and paste it into blobbers and validators settings. These are found in blobber/config directory.
Navigate to the config directory :
cd blobber/config
You will see blobber and validation files listed
12. Open both the configuration files and edit the delegate_wallet value with client_id copied from wallet.
Here is a sample configuration file below:
# [configurations above]
​
# for testing
#  500 MB - 536870912
#    1 GB - 1073741824
#    2 GB - 2147483648
#    3 GB - 3221225472
capacity: 1073741824 # 1 GB bytes total blobber capacity
read_price: 0.01     # token / GB for reading
write_price: 1.00    # token / GB for writing
# min_lock_demand is value in [0; 1] range; it represents number of tokens the
# blobber earned even if a user will not read or write something
# to an allocation; the number of tokens will be calculated by the following
# formula
#
#     allocation_size * write_price * min_lock_demand
#
min_lock_demand: 0.1
# max_offer_duration restrict long contacts where,
# in the future, prices can be changed
max_offer_duration: 744h # 31 day
challenge_completion_time: 1m # 15m # duration to complete a challenge
​
# delegate wallet for all rewards, if it's empty, then blobber ID used
delegate_wallet: 'b145bf241eab00c9865a3551b18028a6d12b3ef84df8b4a5c317c8d184a82412'
Run Blobbers
1. In blobber/docker.localdirectory there would be six blobbers created with different folder numbers. See the screenshot below:
2. Navigate to any of the blobber(for example blobber 2) directory using
cd blobber/docker.local/blobber2
3. Run the blobber container using the below command
../bin/blobber.start_bls.sh
Here is a sample output of blobber2 successfully running:
4. Now to check whether blobber is properly running by visit them at the following link localhost:blobber port number
For blobber 1 the port number is 5051 .In our case we started blobber2 so it would be 5052
Here is the sample output:
blobber running.png
63KB
Image
5. You can repeat step 2 for start the other blobbers .
6.Now to check whether blobbers has joined the 0chain network navigate to zboxcli directory and run the following command
./zbox ls-blobbers
Sample Response:
- id:                    f65af5d64000c7cd2883f4910eb69086f9d6e6635c744e62afcfab58b938ee25
  url:                   http://198.18.0.91:5052
  used / total capacity: 0 B / 1.0 GiB
  last_health_check:	  1635347950
  terms:
    read_price:          10.000 mZCN / GB
    write_price:         100.000 mZCN / GB / time_unit
    min_lock_demand:     0.1
    cct:                 2m0s
    max_offer_duration:  744h0m0s
- id:                    0bf5ae461d6474ca1bebba028ea57d646043bbfb6a4188348fd649f0deec5df2
  url:                   http://beta.0chain.net:31304
  used / total capacity: 14.0 GiB / 100.0 GiB
  last_health_check:	  1635347306
  terms:
    read_price:          26.874 mZCN / GB
    write_price:         26.874 mZCN / GB / time_unit
    min_lock_demand:     0.1
    cct:                 2m0s
    max_offer_duration:  744h0m0s
​
- id:                    71ac0a40d18ee48f53e73189007ce2c1e8769993c7713aeef07640b53a60149f
  url:                   http://beta.0chain.net:31302
  used / total capacity: 12.7 GiB / 100.0 GiB
  last_health_check:	  1635347348
  terms:
    read_price:          26.865 mZCN / GB
    write_price:         26.865 mZCN / GB / time_unit
    min_lock_demand:     0.1
    cct:                 2m0s
    max_offer_duration:  744h0m0s
- id:                    7a90e6790bcd3d78422d7a230390edc102870fe58c15472073922024985b1c7d
  url:                   http://198.18.0.92:5052
  used / total capacity: 0 B / 1.0 GiB
  last_health_check:	  1635347427
  terms:
    read_price:          10.000 mZCN / GB
    write_price:         100.000 mZCN / GB / time_unit
    min_lock_demand:     0.1
    cct:                 2m0s
    max_offer_duration:  744h0m0s
- id:                    f65af5d64000c7cd2883f4910eb69086f9d6e6635c744e62afcfab58b938ee25
  url:                   http://198.18.0.91:5051
  used / total capacity: 0 B / 1.0 GiB
  last_health_check:	  1635347950
  terms:
    read_price:          10.000 mZCN / GB
    write_price:         100.000 mZCN / GB / time_unit
    min_lock_demand:     0.1
    cct:                 2m0s
    max_offer_duration:  744h0m0s
- id:                    f8dc4aaf3bb32ae0f4ed575dd6931a42b75e546e07cb37a6e1c6aaf1225891c5
  url:                   http://beta.0chain.net:31305
  used / total capacity: 13.3 GiB / 100.0 GiB
  last_health_check:	  1635347346
  terms:
    read_price:          26.874 mZCN / GB
    write_price:         26.865 mZCN / GB / time_unit
    min_lock_demand:     0.1
    cct:                 2m0s
    max_offer_duration:  744h0m0s
In the response you should see the locally running blobbers mentioned with their urls for example http://198.18.0.92:5052.
Last modified 1mo ago