Host maintenance
Transaction costs
As mentioned in System requirements, you need to keep a sufficient XAH balance in the host account to cover the transaction fees for your host. Transaction feed originates from Heartbeat transactions sent to the hook as well as instance creation replies sent back to tenants.
Evernode status and version
You can run evernode status and see all the host status info.
Your Evernode version will be shown there in the status output. And the version’s first digit reflects the Ubuntu version you are running. Check here to see how it’s determined.
Updating the Evernode software
You can run evernode update to check and install updates to Evernode.
Or based on your OS version
Ubuntu 20.04
curl -fsSL https://raw.githubusercontent.com/EvernodeXRPL/evernode-resources/main/sashimono/installer/evernode.sh | sudo bash -s update
Ubuntu 24.04
curl -fsSL https://raw.githubusercontent.com/EvernodeXRPL/evernode-24-resources/main/sashimono/installer/evernode.sh | sudo bash -s update
Recovering from a Failed Update
In the event of a failure, the secret will not be deleted and will remain at the default secret file location or the custom location you have specified. If you wish to reinstall, use the following command based on your OS and transfer the registration using the same account on a separate machine. Then try re-installing on your machine.
Ubuntu 20.04
curl -fsSL https://raw.githubusercontent.com/EvernodeXRPL/evernode-resources/main/sashimono/installer/evernode.sh | sudo bash -s transfer
Ubuntu 24.04
curl -fsSL https://raw.githubusercontent.com/EvernodeXRPL/evernode-24-resources/main/sashimono/installer/evernode.sh | sudo bash -s transfer
Host machine OS Upgrade/Downgrade
Even though Evernode supports Ubuntu 20.04 and 24.04, If you upgrade or downgrade your host machine’s Ubuntu version while Evernode is installed, Your Evernode will stop working due to the compatibility issues. If you are planing to do so, You should transfer your Evernode registration before upgrade/downgrade and install Evernode using the respective installer after the upgrade/downgrade.
Purging bad actors
It cannot be avoided that some DApp instances running on your host will misbehave or perform malicious activities across the internet. They cannot harm the operation of other DApps or your Host but they can utilize your network bandwidth or may engage in unethical behavior. When you identify such DApp instances You can use evernode list and evernode delete CLI commands to purge them from your host. See evernode CLI.
Transfer the host registration
If you need to transfer existing registration to another Xahau account or replace your host, you can use this. This is useful in several scenarios:
Upgrading the hardware of your host
Moving your registration to a different host
Reinstalling the host OS
Replacing a damaged host.
Transferring the ownership to a different Xahau account.
In the above cases, you can initiate an evernode transfer from your original account and then install Evernode on the new Host using the transfer information. The re-installation will not cost the regular host registration fee. It will just be a 1 Now(1*10-8 EVRs)).
Transfer Process Steps
1. Initiate the Transfer
You can use the below command to initiate a transfer of the registration token.
evernode transfer
However, if you have lost access to your original host (eg. a damaged host), you can use the following command in any Linux terminal where Evernode is not installed. You are required to possess the Xahau account address and secret of your original host.
curl -fsSL https://raw.githubusercontent.com/EvernodeXRPL/evernode-resources/main/sashimono/installer/evernode.sh | sudo bash -s transfer
2. Reinstall Evernode
Once the transfer is initiated, reinstall Evernode on the new host. Use the standard installation command, and provide the Xahau account and secret of the original host during installation.
curl -fsSL https://raw.githubusercontent.com/EvernodeXRPL/evernode-resources/main/sashimono/installer/evernode.sh | sudo bash -s install
Deregister a host
curl -fsSL https://raw.githubusercontent.com/EvernodeXRPL/evernode-resources/main/sashimono/installer/evernode.sh | sudo bash -s deregister
Note: If you have already installed evernode, you cannot use the deregister command. Use evernode uninstall to uninstall Evernode.
Recovering EVRs from a failed Installation
In the event of a failure, you can use deregister command from a separate machine where evernode is not installed to recover your EVRs. Then try re-installing on your machine.
Diagnostics
Here we have documented some solutions for some possible issues that you might come across on Installation, Update or Transfer.