Run a Node with Docker
Last updated
This guide outlines the process of setting up and operating a KUB node using Docker. Docker provides a streamlined and efficient method for running KUB Mainnet nodes, including Validator Node, Full Node, and Archive Node configurations.
Running a KUB node using Docker is designed to simplify node deployment by providing pre-configured Docker Compose setups. It encapsulates all the essential services required to run various types of KUB Mainnet nodes, ensuring a quick and reliable deployment.
Before you begin, ensure you have the following software installed on your system:
Docker: A platform for developing, shipping, and running applications in containers.
Docker Compose: A tool for defining and running multi-container Docker applications.
To initiate the node deployment, you'll first need to clone the bkc-node-docker repository and navigate into the mainnet directory, which contains the specific configurations for the KUB Mainnet.
git clone https://github.com/kub-chain/bkc-node-docker
cd bkc-node-docker/mainnetUnlike some other blockchain node setups that rely on .env files for configuration, bkc-node-docker adopts a different strategy. It provides distinct docker-compose files tailored for each node type.
This approach simplifies configuration by allowing you to select the appropriate docker-compose file directly when launching your node, eliminating the need for extensive environment variable management.
Once you've successfully navigated to the bkc-node-docker/mainnet directory, you can proceed to launch your desired KUB node type using the respective Docker Compose command. These commands will start the node services in the background, allowing them to run continuously.
Docker Compose provides robust tools for interacting with and managing the various containers that comprise your KUB node.
The bkc-node-docker setup includes integrated monitoring solutions to help you keep track of your node's health and synchronization progress.
A Grafana dashboard is available for detailed monitoring and visualization of your node's metrics. Access it by navigating to http://localhost:8080 in your web browser.
Default Username: admin
Default Password: admin
For a more concise overview of your node's operational statistics, you can access the Stats Dashboard at http://localhost:8090 in your browser.
Last updated
docker compose -f docker-compose.validator.yaml up -ddocker compose -f docker-compose.fullnode.yaml up -ddocker compose -f docker-compose.archivenode.yaml up -d