Installing KENSHO

Prerequisites

Before proceeding, please ensure that you meet the minimum system & software requirements to operate a node. If these requirements are met, you should be able to launch a Consensus node (a.k.a Validator node) and other types of KIRA nodes in a home environment, even using off-the-shelf single-board computers like a Raspberry Pi. There are no slashing penalties for Consensus node going offline or becoming temporarily inaccessible. Nodes that remain offline for an extended period will become inactivate and be automatically removed from the consensus by the state machine, SEKAI. For more details on enforcement rules, see Jailing & Slashing Procedures and for the rank-based uptime system, refer to Consensus Nodes Ranking & Status Management.

The network is designed to halt if ≥ 1/3 of consensus nodes suddenly become unresponsive. However, if individual nodes randomly leave and enter the consensus, there should be no interruption to network operation. As long as the number of validators doesn't fall below min_validators (as defined in Network Properties), the chain will continue producing new blocks. For more details on the network's behavior in such cases, see Poor Network Conditions.

Downloading and Installing Kensho

Using KENSHO is the quickest way to run your node on the KIRA Network. KENSHO is a user-friendly Consensus node operator interface that replaces the deprecated Kira Manager 1.0 (a.k.a KM1). It allows you to easily deploy infrastructure, launch a full node, and claim a Consensus node seat on both the testnet and mainnet. Once you're comfortable with the process, you can refer to our public documentation page for more detailed information on how to use SEKAI and INTERX.

Currently, KENSHO supports Windows and Linux (Debian-based distributions). A MacOS version will be added soon, but can be built using Fyne for those who need it immediately. We also have plans to release an Android version in the future.

Windows/Linux

Windows/linux

Visit the KENSHO RELEASES page to choose the appropriate version for your system. Download the .zip or .deb file, unpack it, and launch the application.

Windows

1. Download and unpack the .zip file:
   • Choose either Kensho-windows-amd64.zip or Kensho-windows-arm64.zip based on your system.
   • Unzip the file using File Explorer or a tool like 7-Zip.
2. Launch Kensho: Navigate to the unzipped folder and double-click the kensho.exe file to launch the application.

Linux

1. Download and unpack the .deb file:

   • Choose either kensho-amd64.deb or kensho-arm64.deb based on your system's architecture.
   • Download the file and unpack it using:

   sudo dpkg -i kensho-amd64.deb
   # or for ARM64
   sudo dpkg -i kensho-arm64.deb

2. Launch Kensho: After installing, you can run the application from the terminal:

   kensho

Mac

Mac

note

macOS support is coming soon to our CI/CD pipeline. Until then, please use fyne-cross to build KENSHO for macOS. Thanks for your patience!

Prerequisites

Ensure you have the following installed on your Mac:

• Go: brew install go
• Fyne CLI: go install fyne.io/fyne/v2/cmd/fyne@latest
• fyne-cross: go install github.com/fyne-io/fyne-cross@latest

Steps to Build Kensho

1. Clone the repository and switch to the master branch:

   git clone https://github.com/KiraCore/kensho.git
   cd kensho
   git checkout master
   git pull origin master

2. Build for macOS (arm64):

   fyne-cross darwin -arch arm64

3. Run the compiled binary:

   ./fyne-cross/bin/darwin-arm64/kensho