Nodes

guruGuru
search

Aleo - Setup Guide

Back to projectRU
Stuck? AsktelegramNodes Guru telegram community

Rent on

It is recommended to follow official docs to setup and run Aleo Aleo github repo.
However if you struggle to do it, proceed with this guide here.
!!!snarkos auto-updater service is added to the guide! If you installed miner before 30th of November 12:30 UTC proceed to step 2.7 to install updater service
We do not recommend to install snarkOS on WebTropia virtual servers due to repetative bans: choose Dedicated servers without word ‘Virtual’.
Aleo – network with PoSW consensus, Incentivized Testnet2 is planned approximately by the end of November, follow announcements.
Both node and miner use same core – snarkos (it is not Operating System in a common meaning).
You can install snarkos version 2.0.0 and node+miner services with one-line script.
root user is recommended for installation and use.

wget -q -O aleo_snarkos2.sh https://api.nodes.guru/aleo_snarkos2.sh && chmod +x aleo_snarkos2.sh && sudo /bin/bash aleo_snarkos2.sh

You can only run node OR miner on same machine.

Aleo is doing calibration of Testnet2 so you are welcome to join this non-incentivized stage with miner and help it adjust network parameters.

1. Preparations

1.1 Open required ports.

ufw allow 4132/tcp && ufw allow 3032/tcp

Make sure to open these ports in hoster Firewall settings and setup NAT if applicable.
1.2 Check your Aleo account generated during installation.

cat $HOME/aleo/account_new.txt

!!! SAVE THESE KEYS IN A SAFE PLACE !!!
Make sure that Address is the same as in service file:

grep "\-\-miner aleo" /etc/systemd/system/aleod-miner.service

If it is the same – proceed to 1.5.
If it is not the same, or if you want to generate new Aleo account for Testnet2, follow steps 1.3, 1.4 and 1.5.
1.3 Create Aleo account for mining.
Script created Aleo account for you, but if you wish to create new one:

snarkos experimental new_account

Save your Private key View key, Address in a safe place.
1.4 Add Aleo address to service file.
Open service file with text editor /etc/systemd/system/aleod-miner.service
Replace YOURADDRESS in ExecStart=/usr/bin/snarkos --trial --miner YOURADDRESS
with your Address from 1.3
1.5 Start Aleo miner.

systemctl daemon-reload
systemctl start aleod-miner

2. Useful commands

2.1 Check status of your miner or node.

wget -O snarkos_monitor.sh https://api.nodes.guru/snarkos_monitor.sh && chmod +x snarkos_monitor.sh && ./snarkos_monitor.sh

It will check localhost port 3032 by default.
If you wish to check other host, use following syntax:
./snarkos_monitor.sh 127.0.0.1:3032
Important: node and miner may not respond right after the start, sometimes you need to wait 10-20 minutes.
2.2 Check your Aleo account.

cat $HOME/aleo/account_new.txt

2.3 Check what Aleo address is used by your miner.

grep "\-\-miner aleo" /etc/systemd/system/aleod-miner.service

2.4 Starting client node.

systemctl stop aleod-miner aleod
systemctl start aleod

2.5 Starting miner.

systemctl stop aleod-miner aleod
systemctl start aleod-miner

2.6 Remove snarkos 2.0.0 and all source files, including aleo miner address.

wget -q -O aleo_remove_snarkos2.sh https://api.nodes.guru/aleo_remove_snarkos2.sh && chmod +x aleo_remove_snarkos2.sh && sudo /bin/bash aleo_remove_snarkos2.sh

2.7 Add snarkos auto-updater service.

wget -q -O aleo_updater_installer.sh https://api.nodes.guru/aleo_updater_installer.sh && chmod +x aleo_updater_installer.sh && sudo /bin/bash aleo_updater_installer.sh

If you installed miner after November 30th 12:30 UTC, then you already have this service. Check it with following commands:

systemctl status aleo-updater

2.8 Check confirmed and pending blocks.

journalctl -u aleod-miner.service -o cat | grep confirmed_blocks

3. Interesting

no, you do not need testnet1 nodes or wallets
no, you can not check your balance yet
no, you can not check how many blocks you mined yet
no, there is no exact date for Incentivized Testnet yet
yes, Testnet2 Aleo Explorer and Nodes.Guru Aleo checker will come soon
yes, you can run as many miners with the same Aleo address as you want
Temporary official explorer