Run first node
Steps to set up the first Kore node
To launch a kore node, you must run the kore-http binary, located in the client folder of the repository. To use your Docker image, you must go to the dockerhub page.
If we do not have the image or do not have the latest version, download it with:
docker pull koreadmin/kore-http:0.5-sqlite
We can execute it by launching:
docker run koreadmin/kore-http:0.5-sqlite
However, this will give us an error, since we must specify certain aspects of the configuration.
We can generate the cryptographic key ourselves or let the node generate it. In this tutorial the node will take care of that task.
- The first thing we must add to the configuration is the private key. We can generate a valid one using kore-tools, which is located in the same repository as the client in the kore-tools directory. Specifically, its keygen binary, which will create the necessary cryptographic material for the node.
It is important to note that the same cryptographic scheme must be used when generating the key and adding it to the client, keygen and client use CAUTION
ed25519
by default.
- Once we have the image we must generate a configuration file indicating the following:
.
listen_addresses
Address where the node will listen to communicate with other nodes. .boot_nodes
a vector of known nodes, as it is the first node we will leave it empty.
// config.json
{
"kore": {
"network": {
"listen_addresses": ["/ip4/0.0.0.0/tcp/50000"],
"routing": {
"boot_nodes": [""]
}
}
}
}
To raise the node we must indicate from which port of our machine we can access the API, as well as the port where the node will listen. Finally, it is important to indicate the configuration file.
docker run -p 3000:3000 -p 50000:50000 -e KORE_PASSWORD=polopo -e KORE_FILE_PATH=./config.json -v ./config.json:/config.json koreadmin/kore-http:0.5-sqlite
To learn more about environment variables go to the INFO configuration section
Last modified: June 14, 2024