☁️
Zus Docs
  • About Züs
  • System
    • Providers and Services
      • Miner
      • Sharder
      • Blobber
      • Validator
      • Authorizer
      • Node Locator (0DNS)
    • Storage
      • Architecture and Data Management
      • Protocol
        • Allocations
        • Reference Objects
        • Challenges
        • Write Markers
          • Chain Hashing
          • Two Commit
        • Blobber Repair Protocol
      • ZS3 Server
        • Backup, Recovery and Replication
        • Encryption and Compression
        • S3FS Setup and Usage
        • Backup & Recovery with Restic on Blimp + ZS3 Server
        • Backup & Recovery with Veeam on Blimp + ZS3 Server
      • File Operations
        • Upload
        • Download
        • File Sharing
        • Partial Error Recovery
        • Streaming
        • Rent a Blobber
    • Smart Contracts
      • Storage S.C.
      • Miner S.C.
      • ZCN S.C.
      • ERC-20 S.C.s
      • Bridge Protocol
    • Blockchain & Consensus
      • Entities
    • User Authentication and Wallet Management System
      • OKTA Integration
      • Key Management System (KMS)
  • APIs
    • 0DNS API
    • JS API
    • Mobile API
  • CLIs
    • Storage CLI
      • Quickstart
      • Configuring the tool
    • Wallet CLI
      • Wallet Configuration
      • Quickstart
      • Configuring the tool
  • SDKs
    • Go SDK
      • GO SDK Microservices
    • JS SDK
  • Tokenomics
    • Staking
    • Reward & Penalty
  • ✨Züs Apps
    • 🗝️Vult
      • Getting Started
        • Web
        • Mobile
      • Vult AI
        • Batch Processing
        • Memory Retention
        • Technical Implementation
        • Architecture Overview
      • Login / Register
      • File Management Pages
      • File Sharing
      • Storage Management Dashboard
      • Storage Maintenance and Troubleshooting
      • Züs Subscription
      • Wallet Management
      • Refer a friend
      • Settings
    • 🏗️Blimp
      • Getting Started
      • Login / Register
      • Configure Storage
        • Create Standard Storage Allocation
        • Create Enterprise Allocation
        • Create S3 Server Allocation
        • Create Cloud Migration Allocation
        • Allocation Maintenance and Troubleshooting
      • File Management Pages
      • File Sharing
      • Manage Allocations
      • Upgrade Storage
      • Blimp Vault
      • Refer a friend
      • Settings
      • Launching ZS3 Server
      • Using CLI to backup files into Blimp + ZS3 Server
    • 🏠Chimney
      • Getting Started
      • Login / Register
      • Create New Deployment
      • Manage Your Deployments
      • Homepage
      • Staking Dashboard
      • Rank Dashboard
      • Monitor Dashboard
      • Stats Dashboard
      • Logs Dashboard
      • Wallet Dashboard
      • Operations on your Deployments
      • Restricted Blobbers
      • Settings
        • Manage Profile
        • Wallet Settings
        • Update Blobber Settings
        • Update Blobber Version
        • Refer a friend
        • Help
    • 🌐Atlus
      • Getting Started
      • Home page
      • Service Providers Page
      • Charts Page
        • Market Charts
        • Network Charts
        • Storage Charts
      • Blockchain Page
      • Server Map Page
      • Storage Explainer Page
      • Details Pages
        • Block Details Page
        • Transaction Details Page
        • Wallet Details Page
        • Miner Details Page
        • Sharder Details Page
        • Blobber Details Page
        • Validator Details Page
        • Authorizer Details Page
        • Allocation Details Page
      • Appendix: Common Components
    • ⚡Bolt
      • Getting Started
        • Web
        • Mobile
      • Login / Register
      • Sign In with external wallet
      • Staking Dashboard
      • Staking/Unstaking a provider
      • Claiming Rewards
      • Send/Receive ZCN tokens
      • Buy ZCN
      • Deposit/Withdraw ZCN tokens
      • Activity Dashboard
      • Refer a friend
      • Settings
  • Releases
    • Hardfork
Powered by GitBook
On this page
  • Prior Knowledge: Chimney Deployment Overview
  • Pre-requisites of the deployment machine
  • Step 1: Server Setup
  • Step 2: Server Rental Options
  • Step 3: Deploy
  • Step 4: Server IP Address or Domain
  • Step 5: Running the Deployment Script
  • Step 6: Deployment Confirmation
  1. Züs Apps
  2. Chimney

Create New Deployment

Host a blobber and get rewards

PreviousLogin / RegisterNextManage Your Deployments

Last updated 1 year ago

This guide provides step-by-step instructions on how to deploy a blobber on the Chimney platform. By the end of this process, you will have a blobber set up to join the Züs network.

Before starting, ensure you have an account on Chimney. Log in or sign up to initiate the deployment process.

Prior Knowledge: Chimney Deployment Overview

Before we go through the steps of creating your deployment, let's take a look on how this deployments look like:

The Chimney deployment consists of 3 main layers:

Blobber Cluster Layer

Here is where you have the blobber and validator containers as well as the database used by the blobber. The blobber and the validator are exposed using the routes: <your-chimney-host-url>/ and <your-chimney-host-url>/validator respectively.

Monitoring/Tracking Layer

Here are the tools that are used to track metrics and logs of the system, docker and the blobber and validator containers. We use:

  • Prometheus with the Node Exporter and cAdvisor agents to collect stats and metrics of the system (CPU Usage - Memory Usage - etc..) as well as Docker stats. Prometheus gathers these metrics and exposes an API that will be used in presentation.

  • Promtail which collects the logs from the blobber and validator to be used in presentation.

  • Portainer Agent is the "backend" of Portainer, which monitors and controls everything related to Docker, including the containers, images and services.

Presentation Layer

  • Grafana + Loki as a presentation GUI and API for logs and metrics. You can access that at: <your-chimney-host-url>/grafana

  • Portainer, which visualizes and controls Docker on your machine. You can access it at:<your-chimney-host-url>/portainer

  • Züs Monitoring API, which exposes a JSON HTTP API where you can access some useful metrics. This API is documented here within our APIs docs.

Now since we got the big picture of the deployment, let's dive into the details of how to create this deployment.

Pre-requisites of the deployment machine

If you'll be self-hosting the Chimney Deployment, make sure that your machine matches the following specifications:

  • Your machine should be running Ubuntu Linux version >= 20.04 LTS.

  • The user used to setup the deployment should be the root user, or have sudo privileges.

  • If you have hardware raid on HDD, please mount it to this path: /var/0chain/blobber/hdd.

  • If you have hardware raid on SSD, please mount it to this path: /var/0chain/blobber/ssd.

  • If you don't have hardware raid on SSD/HDD, you need to set software raid and mount the disks as specified in step 3 & step 4 above. Also create an entry in /etc/fstab file, so that it gets mounted automatically whenever server gets restarted.

Step 1: Server Setup

Upon login, you will be directed to the "Setup a New Server" page. You have two main options:

Step 2: Server Rental Options

If renting:

  • Review the server options available from different providers.

  • Compare specifications and prices.

Step 3: Deploy

On the configuration page:

  • Define your storage service prices under "Write Price / GB / Month"

Note : All Reads are free on Züs.

  • Enter the desired name for your server in the provided field. By default is the your username.

  • Opt to delegate by toggling the relevant option, then set the "Number of Delegates" and the "Service Charge %" to define your earnings.

Input Fields
Description

Write Price / GB / Month

This slider allows you to set the price you will charge users to write data to your blobber per gigabyte per month. Adjusting this will affect your potential earnings.

Read Price / GB

All reads are free on Züs, suggesting no charge for data retrieval.

Name of the server

A mandatory field where you specify the unique identifier for your server, which will be visible to users on the network. Defaulted to your username; It cannot be altered post-deployment.

Do you wish to delegate?

A checkbox that, when enabled, permits other users to stake on your server and share the generated income, diversifying the investment.

Number of Delegates

This slider sets the limit on how many delegates can stake on your server, thereby participating in the income generated from the storage services you offer.

Service Charge

Here you can set the percentage of earnings that will be charged as a service fee. This slider controls the incentive for delegates and can impact the attractiveness of your blobber to potential stakers.

Step 4: Server IP Address or Domain

  • Provide your server’s IP address or domain URL to generate a custom script for deployment.

  • Ensure that your server meets all the prerequisites listed, like the Ubuntu Linux version, root user setup, and minimum mounted capacity. Follow the instructions provided for mounting if needed.

  • After fulfilling all prerequisites, click “Create, fund server wallets and generate script”.

  • A loading message will indicate that the process is in progress.

  • This step automates the process of creating server wallets for blobber and validator, funding the first server wallets for transaction fees, and generating a script to join the network.

  • Once complete, you will receive toast notifications for each successful step.

Make sure that your server meets all the prerequisites listed.

Step 5: Running the Deployment Script

  • Follow the instructions provided on the screen to execute the script on your server.

  • The platform will automatically check the server communication to ensure the script has run successfully.

  • If there's a delay, you may see a warning prompt asking if you're still there and if you have run the script on your server.

If your deployment is taking longer time and you need to continue to the dashboard until your deployment is done, maybe to check if there's an error or fund the wallet of your blobber/validator, you can click the "Continue to the Dashboard" button.

Step 6: Deployment Confirmation

  • If any errors occur, they will be displayed in a toast notification.

CRITICAL: You should keep your deployment online, both available and reachable at the IP address you provided. Any outage in your deployment will lead to penalties. Also please be noted that a 3-week continuous outage will lead to automatically signing your deployment off the network, which lead to a penalty that goes up to even half your staked ZCN amount. This is our contract with our clients, to provide as high-quality of a service as we can, so please be cooperative for the good of both your deployment and the Züs Network.


Here we have the tools that present those collected metrics and logs, and expose a nice GUI web-based app for the owner of the deployment to be able to view and control their deployment, as well as an API that can be used by Chimney to view those information (check and pages). Those tools are:

: Select a storage server from a list of data centers.

: If you have your own server, begin the automated deployment process.

Visit the provider to rent a server or select "" to proceed with your own server.

Upon successful deployment, user will be redirected to the . This is where you can manage and monitor your blobber.

By following these steps, you will have a blobber set up to join the Züs network. If you have any questions or encounter any issues, please join our for further assistance. Our team and the community members are available to help troubleshoot your concerns and provide guidance.

✨
🏠
Dashboard Page
Discord
Logs
Monitor
Rent
Deploy
Deploy
Fig1: Chimney Deployment Diagram
Fig2: Setup a New Server
Fig2: Server Rental Options
Fig3: Configure Blobber Specs
Fig4: Staking Settings
Fig5: Server IP
Fig6: Loading Window
Fig7: Success Messages
Fig8: Script Generated
Fig9: Warning