Run a Full/Light Node
The codebase is currently not public. We will be sharing more details about the node's role and functionality soon. We appreciate your patience and interest. Thank you for your understanding and continued support.
Note: We are in the Alpha Testnet stage (Chain ID: nubit-alphatestnet-1), so the API may undergo incompatible changes in the future. If you encounter any issues, please join our Discord to get in touch with the Nubit Team.
By following these steps, you should be able to successfully set up and start a Nubit Full/Light Node. If you encounter any issues, please provide detailed information, and further assistance will be provided.
Set up the Full/Light Node
Set up the Environment
Download the Necessary Repositories
Clone the nubit-node
repository.
Note: The git clone
command above already specifies the nubit-alphatestnet-1
branch of the nubit-node
repository, which includes the latest version of the code.
When using git clone
, you may need to temporarily comment out the UseKeychain
fields in your ~/.ssh/config
file. Specifically, comment out # IgnoreUnknown UseKeychain
and # UseKeychain yes
.
Make Build and Install
In the cloned repository directory, run the following command to install the CLI:
Set up the Environment
Set Network and Custom Variables
Set up your environment by running the following commands:
Note: Set NODE_TYPE
to light
if you prefer to start a light node.
Clear Previous Data
Remove any existing data to ensure a clean setup:
Initialize the Node
To initialize the node, run the following command. This will automatically generate a nubit address along with its MNEMONIC. Please make sure to securely save the MNEMONIC as it will only appear once.
Synchronize with the Latest Block
To quickly sync to the latest block, a snapshot is provided and updated every 12 hours. Follow these steps:
Remove Old Data Directory
Download the Snapshot
Download the snapshot using wget
. The snapshot file for a full node is approximately 14.1GB and for a light node is 904MB, so ensure you have sufficient disk space available.
Extract the Snapshot
Extract the downloaded snapshot to update your node's data:
This will update your node to a recent state. Keep it running to ensure it syncs to the latest block. For the most current block information, please visit the chain explorer at explorer.nubit.org.
Start the Full/Light Node
Finally, start the node with the command below:
Note: We request user to submit node metrics to our OTEL every 6 minutes. No private information would be leaked in this process.
The following message indicates a successfully running node.
Last updated