Back

Blog details

AIOZ dCDN CLI Node Update

AIOZ Network
4 min readDecember 05, 2023
aioz-depinaioz-storage

Run an AIOZ Node directly from your command line interface and be rewarded for powering AIOZ Network

We are excited to announce that after ongoing requests from the AIOZ community, we have today released the AIOZ dCDN CLI Node implementation.

The AIOZ dCDN CLI Node is software to become an AIOZ Node in AIOZ dCDN. Your Node contributes storage capacity, network bandwidth and computing power to the AIOZ dCDN and in return receives rewards in AIOZ tokens.

If you're looking to run an GUI-less AIOZ Node on your computer, read more below!

What is AIOZ dCDN CLI Node?

AIOZ dCDN CLI Node is the software to become an AIOZ Node in AIOZ dCDN. AIOZ Node contributes storage capacity, network bandwidth and computing power to the AIOZ dCDN and gets rewards in AIOZ Tokens.

Requirements

  • Windows 10 version 22H2 64-bit or above
  • Ubuntu 14.04 64-bit or above
  • macOS Catalina version 10.15 or above

Getting started

Windows

Download and extract the latest AIOZ dCDN CLI Node. The scripts below are written for Windows PowerShell.

curl.exe -LO https://github.com/AIOZNetwork/aioz-depin-cli/files/13561213/aioznode-windows-amd64-1.1.0.zip
Expand-Archive -Path aioznode-windows-amd64-1.1.0.zip -DestinationPath .
ren aioznode-windows-amd64-1.1.0.exe aioznode.exe

Verify the node is runnable

.\aioznode.exe version

The output should be the version of AIOZ dCDN Node.

Generate new mnemonic phrase and private key

.\aioznode.exe keytool new --save-priv-key privkey.json

--save-priv-key write the private key to file

Response

{
        "address": "aioz1k28nzwgrwgzrwfuwsfcqjyvd0r4lfprql2c4uf",
        "address_hex": "0xB28F313903720437278E827009118d78eBf48460",
        "pub_key": "{\"@type\":\"/ethermint.crypto.v1.ethsecp256k1.PubKey\",\"key\":\"AxSwg94OuvFInQXiZtHevsw7gFKvbZXCqFunK3pMjV0I\"}",
        "priv_key": "{\"@type\":\"/ethermint.crypto.v1.ethsecp256k1.PrivKey\",\"key\":\"rdWGOtJ/Uio4SDtubqMUGKn+7doBCCOfegAI9OGMIbE=\"}",
        "mnemonic": "rain wing olive skate effort present long myself combine giant vote stay sweet bundle agree lock connect glide absent spider effort attitude enemy mouse"
}

IMPORTANT NOTE: Make sure to backup and secure your mnemonic phrase as it will be used in case of migration or recovering your node.

Run the node

.\aioznode.exe start --home nodedata --priv-key-file privkey.json

--home data folder of the node

--priv-key-file the private key file which the node starts with. If you do not specify the private key file, the node will ask for it from the standard input stream.

Note:
Because AIOZ dCDN CLI Node automatically updates itself by downloading and replacing the executable file, make sure to set file permission to writable.
AIOZ dCDN CLI Node has to stop to perform auto update, it should be run as Windows Service to start again after update and at system boot.

macOS and Linux

Download the latest AIOZ dCDN CLI Node

For macOS

curl -LO https://github.com/AIOZNetwork/aioz-depin-cli/files/13561206/aioznode-darwin-amd64-1.1.0.tar.gz
tar xzf aioznode-darwin-amd64-1.1.0.tar.gz
mv aioznode-darwin-amd64-1.1.0 aioznode

For Linux

curl -LO https://github.com/AIOZNetwork/aioz-depin-cli/files/13561211/aioznode-linux-amd64-1.1.0.tar.gz
tar xzf aioznode-linux-amd64-1.1.0.tar.gz
mv aioznode-linux-amd64-1.1.0 aioznode

Verify the node is runnable

./aioznode version

The output should be the version of AIOZ dCDN Node.

Generate new mnemonic phrase and private key

./aioznode keytool new --save-priv-key privkey.json

--save-priv-key write the private key to file

Response

{
        "address": "aioz1k28nzwgrwgzrwfuwsfcqjyvd0r4lfprql2c4uf",
        "address_hex": "0xB28F313903720437278E827009118d78eBf48460",
        "pub_key": "{\"@type\":\"/ethermint.crypto.v1.ethsecp256k1.PubKey\",\"key\":\"AxSwg94OuvFInQXiZtHevsw7gFKvbZXCqFunK3pMjV0I\"}",
        "priv_key": "{\"@type\":\"/ethermint.crypto.v1.ethsecp256k1.PrivKey\",\"key\":\"rdWGOtJ/Uio4SDtubqMUGKn+7doBCCOfegAI9OGMIbE=\"}",
        "mnemonic": "rain wing olive skate effort present long myself combine giant vote stay sweet bundle agree lock connect glide absent spider effort attitude enemy mouse"
}

IMPORTANT NOTE: Make sure to backup and secure your mnemonic phrase as it will be used in case of migration or recovering your node.

Run the node

./aioznode start --home nodedata --priv-key-file privkey.json

--home data folder of the node

--priv-key-file the private key file which the node starts with. If you do not specify the private key file, the node will ask for it from the standard input stream.

Note:
Because AIOZ dCDN CLI Node automatically updates itself by downloading and replacing the executable file, make sure to set file permission to writable.
AIOZ dCDN CLI Node has to stop to perform auto update, it should be run with launchctl(macOS) or systemctl(Linux) to start it again after update and at system boot.

Usage

View node status

./aioznode.exe stats

Note: This command requires a running node, if your node is not on default port 1317, you need to specify it with the flag --endpoint

Response

{
        "storage": {
                "total_count": 4864,
                "total_size": 149967615893
        },
        "delivery": {
                "upstream_speed": 0
        }
}

View reward

./aioznode.exe reward balance

Note: This command requires a running node, if your node is not on default port 1317, you need to specify it with the flag --endpoint

Response

{
        "balance": [
                {
                        "denom": "attoaioz",
                        "amount": "7218886258271998637"
                }
        ],
        "storage_earned": [
                {
                        "denom": "attoaioz",
                        "amount": "810423534750216148"
                }
        ],
        "delivery_earned": [
                {
                        "denom": "attoaioz",
                        "amount": "7525653191257749557"
                }
        ],
        "withdraw": [
                {
                        "denom": "attoaioz",
                        "amount": "1100000000000000000"
                }
        ],
        "delivery_counter": 16521
}

Withdraw reward

./aioznode.exe reward withdraw --address 0x9A20600a143745404f1AA1C69Bd280f4bD5B4408 --amount 1aioz --priv-key-file privkey.json

This command requires a running node. If your node is not on default port 1317, you need to specify it with the flag --endpoint.

--address the address to withdraw the reward to. The rewards is transferred in AIOZ Chain.

--amount the amount of reward to withdraw. The unit can be aioz or attoaioz. 1 AIOZ equal 10^18 attoaioz. Minimum withdraw is 1 AIOZ. Example values: 1aioz, 1.1aioz, 1100000000000000000attoaioz.

--priv-key-file the private key file which the node started with. If you do not specify the private key file, the node will ask for it from the standard input stream.

Response

{
        "txid": "2604F553B62B70136967811B14BA8DB5706A2FA86EF7FD1A6899ECB3EF944D59"
}

Recover private key from mnemonic phrase

.\aioznode.exe keytool recover "rain wing olive skate effort present long myself combine giant vote stay sweet bundle agree lock connect glide absent spider effort attitude enemy mouse" --save-pri-key privkey.json

--save-pri-key write the private key to file.

Response

{
        "address": "aioz1k28nzwgrwgzrwfuwsfcqjyvd0r4lfprql2c4uf",
        "address_hex": "0xB28F313903720437278E827009118d78eBf48460",
        "pub_key": "{\"@type\":\"/ethermint.crypto.v1.ethsecp256k1.PubKey\",\"key\":\"AxSwg94OuvFInQXiZtHevsw7gFKvbZXCqFunK3pMjV0I\"}",
        "priv_key": "{\"@type\":\"/ethermint.crypto.v1.ethsecp256k1.PrivKey\",\"key\":\"rdWGOtJ/Uio4SDtubqMUGKn+7doBCCOfegAI9OGMIbE=\"}"
}


Conclusion

The release of the AIOZ dCDN CLI Node implementation enables those with server-specification computers to run AIOZ Nodes at increased levels of productivity.

With the launch of AIOZ W3S imminent, these servers-specs AIOZ dCDN CLI Nodes will contribute even more computing power to the AIOZ Network, resulting in a smooth experience for W3S users and a healthier ecosystem overall.

About the AIOZ Network

AIOZ Network is Web3 Infrastructure for AI, Storage and Streaming.

AIOZ empowers a faster, secure and decentralized future. Powered by a decentralized Content Delivery Network (dCDN), AI computation and thousands of individual nodes run globally, AIOZ rewards you for sharing your computational resources for use in storing, transcoding, and streaming digital media content and powering decentralized AI computation.

Find Us

Website | AIOZ Block Explorer | Twitter | Telegram

We only send updates when meaningful changes ship, and you can unsubscribe anytime

Related Content

blog thumbnail

How to Create a Bucket and Upload a File on AIOZ Storage

Create a bucket and upload a file on AIOZ Storage in five steps: sign up, set a passphrase, add credits, and upload. Plus what the passphrase cannot recover.

aioz-storage
5 min readOctober 20, 2026
blog thumbnail

AIOZ Storage Rate Limit: Working Within 100 Requests/s

The AIOZ Storage rate limit is 100 requests per second. See what the docs do and don't say, and how to stay under it with boto3 retries and a limiter.

aioz-storage
7 min readOctober 16, 2026
blog thumbnail

What AIOZ Storage Erasure Coding Covers and What It Doesn't

AIOZ Storage erasure coding splits each object into pieces on DePIN nodes, so it survives node loss. See what it covers, what it doesn't, and what to back up.

aioz-storage
6 min readOctober 14, 2026
blog thumbnail

How to Rename a File in an S3 Bucket on AIOZ Storage

Rename a file in an S3 bucket on AIOZ Storage from the dashboard, then move, delete and download files, and see which actions the docs say are not supported.

aioz-storage
5 min readOctober 13, 2026
blog thumbnail

AIOZ Storage llms.txt: Docs Built for Super Intelligence

AIOZ Storage publishes llms.txt, a 46-link docs index, and llms-full.txt, all docs in one 164 KB file. See what each file contains and when to use which.

aioz-storage
6 min readOctober 09, 2026
blog thumbnail

Vector Database vs Agent Memory on AIOZ Storage: A Guide

Vector database vs agent memory on AIOZ Storage: use the vector database for control over embeddings and metadata, Memory for simple Record and Recall calls.

aioz-storage
6 min readOctober 06, 2026