Learn More →
Guide prepared by @klimgeran
Donate XYM:
Be sure to check out another guide that is more suitable for Windows users. Guide authorCB:
More details 👉 HERE
This manual will guide you through the process of setting up and connecting to the public SYMBOL network.
Nodes can function with different sets of components depending on your needs. The SYMBOL mainnet nodes are currently distributed in several forms:
Minimum Requirements:
Requirement | Peer node | API node | Dual&Vot node |
---|---|---|---|
CPU | 2 cores | 4 cores | 4 cores |
RAM | 8GB | 16 GB | 16GB |
Disk size | 500 GB | 750 GB | 750 GB |
Disk speed | 1500 IOPS SSD | 1500 IOPS SSD | 1500 IOPS SSD |
https://docs.symbolplatform.com/guides/network/running-a-symbol-node.html
To run our Symbol node, we can use Beget virtual hosting:
Next, choose the minimum “Strong” tariff plan, or you can choose the "Powerful" tariff, although the “Strong” tariff plan should be enough for you.
Make the following settings as shown below:
You can choose other root vps for example: https://www.netcup.eu/vserver.
First, select the root server, confirm the data, go through the registration process, wait for a letter from netcup, verify your personal data.
We get a new password from https://www.servercontrolpanel.de/
We go to your personal account and open the section: Next, move on to installing # centos 8 (core) - minimal
Save your new root password and system data![4] (https://i.imgur.com/j074kaL.png)
Preliminary steps for setting up hosting were shown here. Installation Cent OS 8.x (64 bit)on VPS server https://contabo.com/ is as follows:
Each hosting has its own settings, but this article showed the basic principle of how to properly set up your hosting. So that you can run your Symbol node on your hosting!
Run the Symbol node via the terminal
You need to follow this tutorial to get your Symbol node up and running.
Working in the terminal is pretty simple:
Open the terminal: ssh root@44.132.44.88
ssh root@(Your hosting ip)
Root password, you should have received your password to your email.
Use the following command to create a symbolnode user account:
adduser symbolnode
Set a password for your user account (Symbol node) using the following command:
[enter new password twice]
Add the user to the sudo-enabled user group (we'll need the sudo command to install later) and switch to the symbolnode user account:
Set environment requirements Install and configure docker with the following commands:
(Copy all these commands at once and paste into terminal)
Install docker-compose using the following commands:
(Copy all these commands at once and paste into terminal)
Install docker-compose using the following commands:
(Copy all these commands at once and paste into terminal)
Install node.js using the following commands:
sudo dnf module list nodejs
Install VIM with the following command:
(To test the work of docker, since docker is a platform for developing, delivering and running containerized applications) Enter the command:
You should see the following message in the terminal:
After that, we need to restart the Symbol node server and log in with the symbolnode account we created earlier.
Use this command to reboot the server:
Then again, after restarting the server, open the command line (terminal) and go to your Symbol node:
ssh symbolnode@’your_ip’
(Example: ssh symbolnode@45.141.78.132)
Enter the password you created earlier. You can copy the password using Command + C and paste into the command line (terminal) using Command + V.
Verify environment requirements
To verify that the installation of the environment was successful, we can run the following commands:
For docker, run:
The result should be similar to: Hello from Docker! This message shows that your installation appears to be working correctly. […] For more examples and ideas, visit: https://docs.docker.com/get-started/
For docker-compose, run (Use the command):
The result should be similar to the example below:
docker-compose version 1.28.5, build c4eb3a1f docker-py version: 4.4.4 CPython version: 3.7.10 OpenSSL version: OpenSSL 1.1.0l 10 Sep 2019
To check the version of node.js run the command:
The result should be similar to the example below:
v10.24.0
Once you've verified the installation, you can proceed with the installation of symbol-bootstrap.
Install and configure symbol-bootstrap
Use the following command to install symbol-bootstrap:
You should see the following in the terminal:
Before we will run node Symbol, we will create a custom configuration file custom.yml with VIM.
To do this, run the command:
The custom file should look like this:
For example:
When you're done editing, press CTRL + O to commit the new changes to your custm.yml file and press ENTER. CTRL + X to exit the file.
Or perhaps:
Press ESC, then write the command: wq
Note:
(edit your custom.yml config file) symbol-bootstrap stop vim custom.yml (Open file) Select you want to overwrite: R i (modify file)
Next, we can start the node:
We need to wait 1 minute and the node will start, then we stop our node using the command in the terminal ctrl + c
After the Symbol node has stopped, write the command:
symbol-bootstrap decrypt --source target/addresses.yml --destination plain-addresses.yml
We enter this command
(Save all data, addresses, private, public keys)
Then enter the command to exit
Enter another command (to remove custom.yml)
Checking the system
Run a node:
symbol-bootstrap start -p mainnet -a dual -c custom.yml
Сhecking the node in the browser:
http://yourip:3000/node/info
Obtaining the private key of the main address of your Symbol node and adding the private key to your Symbol Wallet
To send a transaction from the address of the main Symbol node, you need a private key. If you don't have it, you can get it by connecting to your server with your username symbolnode and using the following commands:
We need to write this command in the terminal:
symbol-bootstrap decrypt --source target/addresses.yml --destination plain-addresses.yml
Next, enter the following command: vim plain-addresses.yml
Now you need to import your private key into your Symbol wallet so that you can log into your Symbol node account through the Symbol Wallet.
Your node main account will be displayed in the Accounts section.
Stop node to update settings
(edit your custom.yml config file)
symbol-bootstrap stop
vim custom.yml
(Open file)
Select you want to overwrite:
i (change file) - exit :wq
We need to update the node:
symbol-bootstrap start -p mainnet -a dual -c custom.yml --upgrade -d
Checking the node:
symbol-bootstrap stop
cp -r target targetbackup
sudo npm install -g symbol-bootstrap
symbol-bootstrap start -p mainnet -a dual -c custom.yml --upgrade -d
Version check:
symbol-bootstrap --help
If the update was successful, delete the backup using the command:
rm -r targetbackup
symbol-bootstrap stop
- Stop your node with this commandvim custom.yml
(Open file)
Select you want to overwrite:
i (change file) - exit :wq
Add the following command to get automatic https certificate:
Bootstrap can also take care of obtaining the necessary SSL certificates through the public and free Let’s Encrypt service.
https://twitter.com/GeranKlim/status/1459867514238738437
symbol-bootstrap start -p mainnet -a dual -c custom.yml --upgrade -d
- This command starts a node with updates settings. All done ✅P.S: Remember to open ports 3001 and 80 in your firewall or security group. Port 3000 may or may not be closed. Port 80 is needed by Let’s Encrypt.
First you need to stop the node
Then run the following command
If your node's SSL certificate is about to expire, you need to renew the SSL certificate. A node certificate expires approximately one year (375 days) after it was created. If this is not done, then your Symbol node will stop working.
ssh symbolnode@xxx.xx.xxx.xxx
Checking node status and SSL certificate:
symbol-bootstrap -v
Stop your Symbol node:
symbol-bootstrap stop
Make a backup:
cp -r target targetbackup
The Symbol node does not need to be stopped to renew the certificate, use the commands below to renew the certificate.
🟡 30 days before the symbol node's SSL certificate expires, it will be possible to renew using a command.
symbol-bootstrap renewCertificates
🟢 If the SSL certificate is expiring in a few months but you still want to renew your node certificate use this command.
symbol-bootstrap renewCertificates --force
Run your node: symbol-bootstrap start -p mainnet -a dual -c custom.yml -d
👏 Congratulations, your SSL certificate has been updated.
P.S: Additional command from cryptoBeliever to check the expiration of the SSL certificate:
echo | openssl s_client -showcerts -servername http://nis2.host -connect http://nis2.host:7900 2>/dev/null | openssl x509 -inform pem -noout -text
Replace nis2.host
with your node.
https://twitter.com/GeranKlim/status/1496563089978048512