Comment on page
Running a Storage Node
The recommended requirement of a storage server:
Resource | Specification |
---|---|
Recommended OS | Linux 64-bit Intel / AMD |
# of CPU Cores | ≥ 4 |
Memory | ≥ 8 GB |
Bandwidth | ≥ 5 Mbps |
Public Network IP | required |
Linux Kernel Version | 5.11 or higher |
The following commands are executed with root privileges. If error messages of
permission denied
appear, switch to root privilege or add sudo
at the beginning of these commands.By default, the node client program, cess-bucket, uses port 4001 to listen for incoming connections, if your OS firewalled the port by default, you may need to enable the access to the port.
ufw allow 4001
Check the hard disk status using the
df -h
command:$ df -h
If the disk is not mounted, the hard drive for storage mining cannot be used. Use the commands below to view unmounted hard disks:
$ fdisk -l
Disk /dev/vdb: 200 GiB, 214748364800 bytes, 419430400 sectors
Units: sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes
Disklabel type: dos
Disk identifier: 0x331195d1
From the above, we can see that the unmounted disk is
/dev/vdb
. We will be using /dev/vdb
to demonstrate the mounting operation.Allocate the
/dev/vdb
disk:fdisk /dev/vdb
Enter and press Enter:
n
p
1
2048
the value after default
w
Format the newly divided disk into ext4 format:
mkfs.ext4 /dev/vdb
Enter "y" to continue if the system asks to proceed:
Proceed anyway? (y,N) y
Create
/cess
directory to mount the disk. Using /cess
as an example:mkdir /cess
echo "/dev/vdb /cess ext4 defaults 0 0" >> /etc/fstab
Replace
/dev/vdb
with your own disk name. /cess has to remain the same as created in the previous step. If you are not under root privileges, try:echo "/dev/vdb /cess ext4 defaults 0 0" | sudo tee -a /etc/fstab
Mount
/cess
:mount -a
Check the disk mounting status:
df -h
If
/cess
appears, the disk has been successfully mounted.Miners need to create two wallet accounts.
- Earning Account: Used for receiving rewards from mining.
- Staking Account: Used for staking and signing blockchain transactions.
Please refer to Creating CESS Accounts for creating a CESS account, goto CESS faucet to get our testnet tokens, TCESS, or contact us to get assistance.
wget https://github.com/CESSProject/cess-nodeadm/archive/v0.5.1.tar.gz
tar -xvf v0.5.1.tar.gz
cd cess-nodeadm-0.5.1/
./install.sh
If a message
Install cess nodeadm success
shows up, the installation is successful.Run
cess config set
$ cess config set
Enter cess node mode from 'authority/storage/watcher' (current: watcher, press enter to skip): storage
Enter cess storage listener port (current: 15001, press enter to skip):
Enter cess storage earnings account (current: cXiqKzVVamJ2d5cMKomh1ED4prAnKevr2v3nZgNH87HRuY4Xy, press enter to skip):
Enter cess storage staking signature phrase (current: situate double coral cycle ritual country rebuild ridge slush smoke verb acquire, press enter to skip):
Enter cess storage disk path (current: /mnt/storage-disk, press enter to skip):
Enter cess storage space, by GB unit (current: 300, press enter to skip):
Enter the number of CPU cores used for mining; Your CPU cores are 4
(current: 3, 0 means all cores are used; press enter to skip):
Set configurations successfully
Start CESS bucket
$ cess start
[+] Running 3/0
✔ Container chain Running 0.0s
✔ Container bucket Running 0.0s
✔ Container watchtower Running 0.0s
docker logs chain
As shown below, if we see that the height of the block corresponding to "best" is about the latest height in CESS Explorer, it means the local chain node synchronization is completed.

CESS Blockchain Synchronization Completed
Only when the chain synchronization is completed can you operate other functions such as increase the staking, view the status of the node, etc.
docker logs bucket
As shown below, seeing
/kldr-testnet
indicates that the network environment is a test network, and seeing Connected to the bootstrap node...
indicates that there is a connection to the bootstrap node.
Storage Node Log
cess bucket stat
An example of the returned results is shown below:

CESS Bucket Stat
cess bucket increase <deposit amount>
After your node has exited CESS Network (see below), run
cess bucket withdraw
cess bucket reward
cess bucket claim
cess pullimg
cess down
cess bucket update earnings [earnings account]
cess bucket exit
cess stop
cess down
Do not perform this operation unless the CESS network has been redeployed and it is confirmed that the data can be cleared.
cess purge
wget https://github.com/CESSProject/cess-nodeadm/archive/<new-version>.tar.gz
tar -xvf <new-version>.tar.gz
cd cess-nodeadm-<new-version>
./install.sh --skip-dep
cess pullimg
Last modified 9d ago