Running a Tezos node on the *alphanet* and the *zeronet* made super-simple (with RPI3)


Please visit for updates and support of Tezos on RPI3

This update of an earlier post adds the possibility to run a node with a precompiled Tezos program for the zeronet network with RPI3.

If you had already a lot of fun with the alphanet following the recipe in my previous post, jump here(*) (next paragraph).

If you are wondering what to do with a blank SD card on one hand and a brand new RPI3 model B (or even better a RPI3 model B+) on the other hand, just start following the instructions in my previous post (few simple steps) here: Running a Tezos node made ultra-simple (with RPI3)
if you are planning to run the node only on the zeronet, stop following the old instructions after the command “./” and jump to the next paragraph (*).
if you are planning to run the node on the alphanet and also the zeronet then go one step further and stop after the command “./”, then follow the procedure here below.

(*) For anyone.
Stop the node if it is running. If the RPI3 is off, just boot it then download the zip file
by typing on the terminal from the default location /home/tzuser:

Next, download the script “”:

and change the access rules:
chmod 764

Run the script by typing:

it will extract the zip file content and do few more things (the zip file will be automatically deleted after installation).
Now regardless whether you had previously ran the node on the alphanet or not, type:

a new identity for the node is created with this command since you are on a different network. As with the alphanet, the above command is needed only once.

Ready to surf on the zeronet? just type:
and the magic will happen. That’s it!

If you want to switch from the zeronet to the alphanet or vice versa, just stop the node with the script “” then type “” and you are ready to start playing with the other network with “./”

In summary, the commands to start/stop the node on the zeronet are the same as with the alphanet. If at some point you decide to change network, stop the node, run the script “” and start the node again, now it will be on the alternative network.

A little background info (optional reading).
The script “” preserves any previous info for both networks (identity, blockchain, etc). For example going from the alphanet to the zeronet, it will simply move everything from the default folders into 3 temporary folders-alpha (/tezos-alpha, /.tezos-node-alpha and./tezos-client-alpha) and move the zeronet stuff from the temporary folders-zero (/tezos-zero, /.tezos-node-zero and./tezos-client-zero) into the default folders.

The script “” is slightly different for the two networks therefore it is preserved in the files “” and “”. No need to worry, the script “” will copy for you the right file version in “”.
For practical purposes the script “” is all that is needed to run the node either on the alphanet or the zeronet. The file “config.json” is also slightly different for the alphanet and zeronet network. The two versions are stored in their temporary folders.

Have a look at the new tezos-client front-end, it is much nicer and easier to use with the zeronet (great job of the Tezos Development team!). General manual: /home/tzuser/tezos/tezos-client man

The zeronet network is still quite volatile, and I decided to put a limit on the allocated CPU resources for the tezos-node program using a small utility called cpulimit. At the moment the CPU limit for the tezos-node program is set to 80% of the total RPI3 CPU resources. It is more a precaution than a real need,
from what I have seen it rarely happens to go beyond ~50%. You can monitor the situation typing “ps aux” and in case, change the limit by editing the file

In future I am also planning to introduce a small script attached to the crontab scheduler to monitor the RAM usage and eventually, if needed, restart the node before the end of the regular cycle (3 days).

Since Tezos for the zeronet is constantly evolving, I will try to post new precompiled versions for RPI3 possibly every ~week. It is fairly easy to do, once I have the new Tezos compiled, something that I will do for myself anyway, it is only a matter of zipping the Tezos folder and upload it. Then you can just download the new zip file and follow the same procedure above here.

I am postponing the release of revised notes on how to manually compile Tezos specifically for the zeronet network on RPI3 (something similar to this: Step by step setup of a Raspberry Pi 3 with Fedora linux-OS and Tezos until things are settled a bit and/or when we are approaching the betanet or mainnet stage.
But if you have any question please let me know, I will be happy to help and exchange info.

Let’s make Tezos the first blockchain technology spreading everywhere through a swarm of tiny machines.


Looking forward to getting this running this weekend or sooner. Thanks!


@glebowski, thanks, yes please give it a try, it will be good to have more people on the zeronet




Excelent work!
Kudos for you


glad to hear it worked,
soon the RPI3s will take over the zeronet!


Awesome notes… worked like a charm. Thanks for putting this together !!!


Excellent news!
Please follow the updates on the new wiki home page and you are more than welcome to add material to the site if you like.


Hey @maxtez-raspbaker - just wanted to let you know I’m now running the zeronet and finally it works as it should (they fixed the high read operations bug it seems so no more memory issues). Since I don’t have a good keyboard I ran it via ssh. I followed these steps:

Download image
burn on SSD with etcher

Open RPI3:
sudo systemctl start sshd.service;
sudo systemctl enable sshd.service;
ssh -l tzuser

chmod 764

Finally, to start manually:
tezos/tezos-node run

And to query the ‘head’ block:
tezos/tezos-client rpc call blocks/head with ‘{}’

So yes, a lot less painful than manually compiling myself :smiley:
Thanks for your efforts!!


This is great! the swarm is growing by the day…
feel free to contribute to the wiki, it is also your fault(!?*) if we got this far…


Running into two oddities thus far: when I run, it returns the following error: “mv: cannot stat ‘./.tezos-client’: No such file or directory”

Additionally when I attempt to run ./ I get the following errors:

xterm: Xt error: Can’t open display: :0

Anyone experience these before? Running a raspberry pi 3.

edit: I should note that it appears the process is running or hung. There’s no textual or graphical feedback but the command prompt has not returned.


Yes, getting same exact error when trying to go from RPi3 Tezos image directly to zeronet…


@wambo I need a bit more info to help you out, the error with the mv command (no such file or directory) should not happen, and the display problem was solved some time ago.
As @glebowski mentioned, I would also guess that you didn’t wget the zip file (or the old one and you are using the old from the image file which was revised soon after.

Maybe have a look at the wiki ( in particular page b-2) and page f) with the updates and see if there is anything that was skipped in your installation. Just remember all the operations should be done from /home/tzuser as a user (tzuser), not as a root.

no worries, you’ll get your node up and running soon!

edit: your edit suggests that your node is running, that’s strange are you inside x-windows? you can open several terminals, right? if so then open a terminal and type ./ then check if there is any step missing from the installation


@maxtez-raspbaker I managed to burn the RPi3 image, then do the 4/4/2018 updates from the github wiki. But when I type ./ I get “Permission denied”. When I run sudo ./ I get an “…suid-root program…” error messaage. Not sure what I’m doing wrong.


@glebowski, good you got the updated zip file.
No mistake on your end, I made a mistake in the script " " that gave the wrong permission to It is fixed now, but you don’t need to re-download
As a user (tzuser) just change the permission
chmod 775
that should do the trick,

happy zeronet!


Just added to :+1:


@maxtez-raspbaker I download the new script but did sudo chmod 775 and now getting "xterm: Xt error: Can’t open display: 1:2


@glebowski, my apologies this is getting unnecessarily messy, I am trying to keep it simple but at the same time adding new files doesn’t help, still learning…

There was no need to download a new the one you already had was the good one, it was just a problem with the permission.

But now you have to download a new file to put back in place the original good one., here:

wget -NO

then change the permission with chmod and the node should be ready to take off.


thanks I really appreciate it, is the perfect spot for people to start getting involved with Tezos.


@maxtez-raspbaker I was able to download again and change the permissions but now I get the following error when execute “sudo ./”

./ line 1: syntax near unexpected token ‘<’
./ line 1: '<html lang=“en”…