Guide: How to set up your AIOZ Network node with Linux

To set up an AIOZ node on Linux today, install AIOZ DePIN Desktop on Ubuntu or run the AIOZ DePIN CLI, choose how much disk to share, keep it running and withdraw rewards to your wallet. This guide first covered the 2021 AIOZ Node app; it now covers AIOZ DePIN.

Updated Nov 4, 2026: rewritten for AIOZ DePIN Desktop 4.2.3 and the DePIN CLI v1.2.6; the 2021 AIOZ Node app steps were removed.

AIOZ DePIN is the app that turns a computer into part of the AIOZ Network. It shares spare storage, bandwidth and compute, and the docs overview says contributors may receive AIOZ token rewards based on verified work and uptime. We offer it in two forms: AIOZ DePIN Desktop, the graphical app for most people, and the AIOZ DePIN CLI, the command-line version for servers, home labs and headless machines.

What do you need to run an AIOZ node on Linux?

The DePIN GUI Desktop docs list these requirements for the desktop app:

• Operating system: Windows, Ubuntu or macOS (Ubuntu is the only Linux distribution the docs name).
• Memory: at least 512 MB of RAM, and more for a smoother experience.
• Network: a stable connection, with 20 Mbps or faster recommended.
• Storage: at least 50 GB of free disk space.
• CPU and GPU: no strict requirement yet, although the docs say future versions may use the GPU for transcoding.

The CLI needs Ubuntu 14.04 64-bit or later, according to the AIOZ DePIN CLI README. The v1.2.6 release ships one Linux build, linux-amd64, so you need a 64-bit x86 machine; that release has no Linux ARM build.

There is no enforced uptime, so you can start and stop the app at any time, but it only receives and processes tasks while it runs. You also need a wallet address on the AIOZ Network for withdrawals, which we cover below.

Option 1: Set up AIOZ DePIN Desktop

Download and install

On the AIOZ DePIN page, click the AIOZ DePIN button and choose Linux from the menu that opens. This downloads AIOZDePIN-4.2.3.zip, about 247 MB, released on October 30, 2026. The zip holds one file, AIOZ DePIN-4.2.3.AppImage, so unzip it, make the AppImage executable with chmod +x and open it. DePIN operations then run in the background while the app is open. The same menu has a DePIN CLI entry, which opens the DePIN CLI releases on GitHub (Option 2 below). If you already run an earlier version, auto updates keep the app current, as the AIOZ DePIN V4.2.0 post explains.

First launch

On first launch, the app walks you through sign-in, and the startup screen shows the installed version (4.2.1 in the docs screenshots) and whether it is up to date.

The main dashboard shows each module with its status, resource use and rewards: Storage, Delivery, a super intelligence compute module and Transcoding (Beta). It also shows your Balance, Total Rewards and Withdrawn amounts next to a Withdraw button. The gear icon opens the controls menu with Pause, Lock, Storage Folder, Storage Details, Remove DePIN Data, Report Error, a guided tour and Log Out.

Set your storage limit

Open the Storage section and set the maximum amount of disk space you want to share. The Update Storage Limit dialog has a slider that runs up to a Max value for your drive, and the app then stays within the limit you save. The docs say bandwidth limits are planned for a future version.

Storage Details, in the controls menu, shows the drive, your storage limit, the space already used and the maximum limit. Its Edit storage limit button takes you back to the slider.

Schedule, pause and lock

A schedule lets the app run only at set times, such as nights or outside working hours. In Add Schedule, pick the days of the week and a start and end time, then save; the docs say you can set time ranges when the app runs or stays idle.

Pause (Ctrl+P) stops DePIN activity when you need the full machine for something else. The confirmation says active tasks will stop and reward distribution will be paused, and Resume starts everything again.

Lock (Ctrl+L) keeps the app running in the background but puts the interface behind your password, which helps on a computer you share with other people.

Change the storage folder or remove data

Storage Folder lets you move DePIN data to another folder or disk, for example after a hardware upgrade. The app warns that changing the storage folder will stop active tasks.

If you stop using the app, Remove DePIN Data deletes all local DePIN data and frees the space. The action is permanent, and once the data is deleted you no longer receive rewards for it.

How do you withdraw AIOZ rewards?

Click Withdraw on the dashboard, enter the Amount (or Max), paste your AIOZ Network wallet address into "To (wallet address)", then click Proceed and confirm. Use an address on the AIOZ Network native chain, not one on another chain.

The AIOZ Web Wallet shows that address in 0x form under Receive with AIOZ Native selected, and the CLI's withdraw example uses the same 0x format. The app then shows the result of the withdrawal so you can track it.

Option 2: Run the AIOZ DePIN CLI on Linux

The docs describe the CLI as the choice for advanced users who want more control, often on servers or in the cloud. The commands below come from the AIOZ DePIN CLI README and the DePIN CLI docs for release v1.2.6, published March 4, 2026.

We ran steps 1 and 2 on Ubuntu 24.04 (x86_64) on Nov 4, 2026, and show their real output. Steps 3 to 6 create a key and join the network, so we did not run them and they are marked "not run".

1. Download the archive and check it against the SHA256SUMS file that the release also publishes:

curl -LO https://github.com/AIOZNetwork/aioz-depin-cli/releases/download/v1.2.6/aioz-depin-linux-amd64-1.2.6.tar.gz
curl -LO https://github.com/AIOZNetwork/aioz-depin-cli/releases/download/v1.2.6/SHA256SUMS
sha256sum --ignore-missing -c SHA256SUMS

On our Ubuntu test machine, the last command printed:

aioz-depin-linux-amd64-1.2.6.tar.gz: OK

2. Extract the archive, rename the binary and check the version with these README commands:

tar -xzf aioz-depin-linux-amd64-1.2.6.tar.gz
mv aioz-depin-cli-linux-amd64 aioz-depin-cli
./aioz-depin-cli version

On our Ubuntu test machine, the version command printed:

{
  "version": "v1.2.6"
}

The extracted file was already executable on our machine, but if your shell reports "permission denied", the DePIN CLI v1.2.5 first-time operator guide says to run chmod +x on the binary.

3. Create a node key (not run) with the keytool command:

./aioz-depin-cli keytool new --save-priv-key privkey.json

The README shows that this prints an AIOZ address (aioz1...), the same address in 0x form, a public key, a private key and a mnemonic phrase, and it writes the private key to privkey.json. If you lose that file but kept the mnemonic, keytool recover rebuilds it.

Keep your node key safe

The private key file and any mnemonic are wallet secrets. Use a dedicated key for each node, keep offline encrypted backups, and never paste the key or mnemonic into a website, chat or support ticket. The README warns that anyone who has them can control your node rewards, so don't reuse the key from your main wallet or an exchange account.

4. Start the node (not run) with your key file:

./aioz-depin-cli start --home depin-data --priv-key-file privkey.json

--home sets the data folder, and --priv-key-file points to your key; without the key flag, the CLI asks for the key on standard input. If you leave out --home, v1.2.6 uses ~/.aioz-depin-cli, according to its start --help output on our test machine. The node only works while this process runs, so keep the terminal session open on a machine that stays on.

The --auto-update flag lets the CLI update itself, but the README calls it experimental and recommends it for testing only. The README documents a service setup for Windows only and none for Linux, so after a reboot or an auto-update, check that the node is running again.

5. Check status and set a storage limit (not run), here 1,000 GB:

./aioz-depin-cli stats
./aioz-depin-cli storage limit 1000 --priv-key-file privkey.json

stats shows storage, delivery and transcoding status. The storage limit is in GB, and you can't set it lower than the space already used.

6. Check and withdraw rewards (not run) with the reward commands:

./aioz-depin-cli reward balance --priv-key-file privkey.json
./aioz-depin-cli reward withdraw --address 0x... --amount 1aioz --priv-key-file privkey.json

In reward balance, balance is what you can withdraw, the *_earned fields are totals per task type, and withdraw is the total already withdrawn. Amounts are in attoaioz, and 1 AIOZ equals 10^18 attoaioz.

The withdraw command needs a running node and sends the reward on the AIOZ Chain. The README sets a minimum withdrawal of 1 AIOZ and allows one withdraw request per hour. The command returns a transaction ID that you can look up on the AIOZ Blockchain Explorer.

How do AIOZ DePIN rewards work?

Your device takes tasks from the network: storing data, delivering content, transcoding video and running super intelligence (SI) compute jobs. The docs say contributors may receive AIOZ token rewards based on verified work and uptime. They don't promise a fixed amount, and neither do we.

Two things affect how much work you get. The app only receives tasks while it runs, so a machine that stays online longer has more chances to complete them. The v1.2.5 operator guide also notes that several devices behind one public IP address share tasks, so each one gets fewer assignments.

FAQ

Which Linux distributions does AIOZ DePIN support?

The docs name Ubuntu for AIOZ DePIN Desktop, and the CLI README lists Ubuntu 14.04 64-bit or later. Other distributions are not listed, so Ubuntu is the safe choice.

Can I run an AIOZ node on a Raspberry Pi or another ARM board?

Not with the official v1.2.6 release, because its only Linux build is linux-amd64, which needs a 64-bit x86 processor.

Should I use AIOZ DePIN Desktop or the CLI on Linux?

Use Desktop on an Ubuntu computer with a screen if you want buttons, a dashboard and a schedule. Use the CLI on a server or headless machine, or if you want to script the node; both contribute to the same network.

Does the node have to run all the time?

No, there is no enforced uptime, but the app only receives and processes tasks while it runs, so more time online means more chances to complete tasks. Use a schedule or Pause to decide when it works.

Where do my AIOZ rewards go?

They build up in the app as your Balance until you withdraw them to a wallet address on the AIOZ Network native chain, and the CLI sets a minimum withdrawal of 1 AIOZ.

Is AIOZ DePIN the same app as the 2021 AIOZ Node app?

No. This guide used to cover the 2021 AIOZ Node app, while AIOZ DePIN Desktop and the AIOZ DePIN CLI are the current apps that the steps above cover.

How do I set up an AIOZ node on Windows or macOS?

See the Windows guide and the macOS guide, which use the same app and the same withdraw steps.

Related Reading

• How to set up an AIOZ node on Windows: the same setup for Windows.
• How to set up an AIOZ node on macOS: the same setup for macOS.
• AIOZ DePIN CLI v1.2.6 setup and upgrade guide: setup, monitoring and upgrading from v1.2.5.
• What changed in DePIN CLI v1.2.6: the release notes in plain language.
• Getting started with AIOZ DePIN CLI v1.2.5: a first-time operator walkthrough.
• Transcoding in AIOZ DePIN V4.2.0: how transcoding tasks work in the desktop app.

About AIOZ

AIOZ is a Blockchain-based Content Delivery Network that is about to bring a revolution to the entertainment industry.

AIOZ utilizes Blockchain to better content distribution through decentralisation. A distributed Content Delivery Network (dCDN) uses Nodes for storing, streaming, and transferring data instead of traditional data centers operating on a P2P model.

AIOZ uses a faster, cheaper, and more robust platform for content streaming making it affordable, fast, and of better quality.

By using this revolutionary technology, AIOZ can efficiently change the way the world streams content. Thus taking the world one step closer to the future.