# Run a Node This guide assumes you're running on Ubuntu 22.04 LTS - the commands will probably work just fine on 20.04 LTS or Debian. ## Basic machine setup 1. SSH into your node 2. Update your machine (Answer yes / ok to the prompts) ``` sudo apt update && sudo apt dist-upgrade -y ``` 1. Install required tools ``` sudo apt install build-essential git unzip curl wget ``` ## Prepare environment Create the `kuji` user and switch to it ``` sudo useradd -m kuji sudo su -s /bin/bash -l kuji ``` ### Install Golang 1. Download `go` 1.21.8 ``` # remove old go version sudo rm -rvf /usr/local/go/ # download recent go version wget https://golang.org/dl/go1.21.8.linux-amd64.tar.gz # install go sudo tar -C /usr/local -xzf go1.21.8.linux-amd64.tar.gz # remove unneeded installer rm go1.21.8.linux-amd64.tar.gz # source go cat <> ~/.profile export GOROOT=/usr/local/go export GOPATH=$HOME/go export GO111MODULE=on export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin EOF source ~/.profile go version ``` ## Now we build! 1. Download the project code and checkout to testnet branch ```bash git clone https://github.com/Team-Kujira/core $HOME/kujira-core cd $HOME/kujira-core git checkout v1.1.0 ``` 1. Build and install `kujirad` (using the `kuji` user created above) ``` make install ``` 1. Verify your binary is working ``` kujirad version ``` ## Running the node If the build succeeds, you should now have the `kujirad` cli in your path (of the `kuji` user). Try invoking with `kujirad` and you should see output like ``` Stargate CosmosHub App Usage: kujirad [command] Available Commands: add-genesis-account Add a genesis account to genesis.json collect-gentxs Collect genesis txs and output a genesis.json file config Create or query an application CLI configuration file debug Tool for helping with debugging your application export Export state to JSON gentx Generate a genesis tx carrying a self delegation help Help about any command .... ``` ## Join the network Now we can initialize the node and join the network. 1. Initialize node's configuration files ```shell export CHAIN_ID=kaiyo-1 # for mainnet export CHAIN_ID=harpoon-4 # for testnet export MONIKER_NAME="" ``` ``` kujirad init "${MONIKER_NAME}" --chain-id ${CHAIN_ID} ``` Replace the `` with your desired validator name. 1. Fetch the genesis `genesis.json` file Mainnet ``` wget https://raw.githubusercontent.com/Team-Kujira/networks/master/mainnet/kaiyo-1.json -O $HOME/.kujira/config/genesis.json ``` Testnet ``` wget https://raw.githubusercontent.com/Team-Kujira/networks/master/testnet/harpoon-4.json -O $HOME/.kujira/config/genesis.json ``` 1. Download the `addrbook.json` file Mainnet ``` wget https://snapshots.polkachu.com/addrbook/kujira/addrbook.json --inet4-only -O $HOME/.kujira/config/addrbook.json ``` Testnet ``` wget https://raw.githubusercontent.com/Team-Kujira/networks/master/testnet/addrbook.json -O $HOME/.kujira/config/addrbook.json ``` Fix your gas fee settings in `$HOME/.kujira/config/app.toml` ```bash sed -i "s/^minimum-gas-prices *=.*/minimum-gas-prices = \"0.0034ukuji,0.01186factory\/kujira1qk00h5atutpsv900x202pxx42npjr9thg58dnqpa72f2p7m2luase444a7\/uusk,0.0119ibc\/295548A78785A1007F232DE286149A6FF512F180AF5657780FC89C009E2C348F,0.00129ibc\/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2,0.01795ibc\/47BD209179859CDE4A2806763D7189B6E6FE13A17880FE2B42DE1E6C1E329E23,0.65943ibc\/3607EB5B5E64DD1C0E12E07F077FF470D5BC4706AFCBC98FE1BA960E5AE4CE07,160416396197ibc\/F3AA7EF362EC5E791FE78A0F4CCC69FEE1F9A7485EB1A8CAB3F6601C00522F10,0.02689ibc\/EFF323CC632EC4F747C61BCE238A758EFDB7699C3226565F7C20DA06509D59A5,0.01495ibc\/DA59C009A0B3B95E0549E6BF7B075C8239285989FF457A8EDDBB56F10B2A6986,0.03139ibc\/A358D7F19237777AF6D8AD0E0F53268F8B18AE8A53ED318095C14D6D7F3B2DB5,0.90403ibc\/4F393C3FCA4190C0A6756CE7F6D897D5D1BE57D6CCB80D0BC87393566A7B6602,559196837ibc\/004EBF085BBED1029326D56BE8A2E67C08CECE670A94AC1947DF413EF5130EB2,5772801ibc\/1B38805B1C75352B28169284F96DF56BDEBD9E8FAC005BDCC8CF0378C82AA8E7,0.01807factory\/kujira1643jxg8wasy5cfcn7xm8rd742yeazcksqlg4d7\/umnta,0.01194ibc\/FE98AAD68F02F03565E9FA39A5E627946699B2B07115889ED812D8BA639576A9,0.00019ibc\/E5CA126979E2FFB4C70C072F8094D07ECF27773B37623AD2BF7582AD0726F0F3\"/;" $HOME/.kujira/config/app.toml ``` Where these individual prices are as follows: ``` "0.0034ukuji 0.01186factory/kujira1qk00h5atutpsv900x202pxx42npjr9thg58dnqpa72f2p7m2luase444a7/uusk 0.0119ibc/295548A78785A1007F232DE286149A6FF512F180AF5657780FC89C009E2C348F 0.00129ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2 0.01795ibc/47BD209179859CDE4A2806763D7189B6E6FE13A17880FE2B42DE1E6C1E329E23 0.65943ibc/3607EB5B5E64DD1C0E12E07F077FF470D5BC4706AFCBC98FE1BA960E5AE4CE07 160416396197ibc/F3AA7EF362EC5E791FE78A0F4CCC69FEE1F9A7485EB1A8CAB3F6601C00522F10 0.02689ibc/EFF323CC632EC4F747C61BCE238A758EFDB7699C3226565F7C20DA06509D59A5 0.01495ibc/DA59C009A0B3B95E0549E6BF7B075C8239285989FF457A8EDDBB56F10B2A6986 0.03139ibc/A358D7F19237777AF6D8AD0E0F53268F8B18AE8A53ED318095C14D6D7F3B2DB5 0.90403ibc/4F393C3FCA4190C0A6756CE7F6D897D5D1BE57D6CCB80D0BC87393566A7B6602 559196837ibc/004EBF085BBED1029326D56BE8A2E67C08CECE670A94AC1947DF413EF5130EB2 5772801ibc/1B38805B1C75352B28169284F96DF56BDEBD9E8FAC005BDCC8CF0378C82AA8E7 0.01807factory/kujira1643jxg8wasy5cfcn7xm8rd742yeazcksqlg4d7/umnta 0.01194ibc/FE98AAD68F02F03565E9FA39A5E627946699B2B07115889ED812D8BA639576A9 0.00019ibc/E5CA126979E2FFB4C70C072F8094D07ECF27773B37623AD2BF7582AD0726F0F3" ``` And update the commit times in `$HOME/.kujira/config/config.toml` ```bash sed -i "s/^timeout_commit *=.*/timeout_commit = \"1500ms\"/;" $HOME/.kujira/config/config.toml ``` Now start the node ```bash $ kujirad start kuji@fsn1-kuji-testnet-01:~$ kujirad start 12:22PM INF starting node with ABCI Tendermint in-process 12:22PM INF Starting multiAppConn service impl=multiAppConn module=proxy 12:22PM INF Starting localClient service connection=query impl=localClient module=abci-client 12:22PM INF Starting localClient service connection=snapshot impl=localClient module=abci-client 12:22PM INF Starting localClient service connection=mempool impl=localClient module=abci-client 12:22PM INF Starting localClient service connection=consensus impl=localClient module=abci-client ``` And then watch a whole bunch of log messages while your node is catching up. After making sure that it works, it's time to install it as a system level service so it always starts with the machine. ## Register the node as a service Drop out of the `kuji` user if you're still in that terminal session. Write `exit` or type `ctrl+d` on your keyboard. 1. Create a service definition file in `/etc/systemd/system/kujirad.service`. Example file that fits with our `kuijrad` install and `kuji` runtime user ``` [Unit] Description=Kujira Daemon After=network.target [Service] Type=simple User=kuji ExecStart=/home/kuji/go/bin/kujirad start --log_level error Restart=on-abort LimitNOFILE=65535 [Install] WantedBy=multi-user.target ``` 1. Reload your systemctl and enable the service: ``` sudo systemctl daemon-reload sudo systemctl enable kujirad ``` 1. And finally start the service: ``` sudo systemctl start kujirad ``` 1. Check the status of the service: ``` systemctl status kujirad.service ``` It should return something like ``` ● kujirad.service - Kujira Daemon Loaded: loaded (/etc/systemd/system/kujirad.service; enabled; vendor preset: enabled) Active: active (running) since Tue 2022-05-24 12:34:26 UTC; 5s ago Main PID: 18490 (kujirad) Tasks: 11 (limit: 4541) Memory: 65.4M CPU: 4.430s CGroup: /system.slice/kujirad.service └─18490 /home/kuji/go/bin/kujirad start ... ``` 1. Check `kujirad` service logs ``` journalctl -u kujirad -f -o cat ``` And the sync status (make sure `jq` is installed) ``` kujirad status 2>&1 | jq .SyncInfo ``` ## Create the validator Once your node has synced, it's time to create a validator. It can be done on a separate machine if preferred. Create a key that will be the validators key. ``` kujirad keys add ``` Replace the `` with your desired validator wallet name. Copy the seed phrase and put it somewhere safe. You will need to make note of the address `kujira...` and use that in the faucet to get some coins. You can check your balance via ``` kujirad query bank balances kujira.... ``` The next part is associating your node with your account, creating the validator ``` export PUBKEY=$(kujirad tendermint show-validator) export CHAIN_ID=kaiyo-1 export MONIKER_NAME="" ``` ``` kujirad tx staking create-validator \ --moniker="${MONIKER_NAME}" \ --amount=1000000ukuji \ --gas-prices=1ukuji \ --pubkey=$PUBKEY \ --from= \ --yes \ --node=tcp://localhost:26657 \ --chain-id=${CHAIN_ID} \ --commission-max-change-rate=0.01 \ --commission-max-rate=0.20 \ --commission-rate=0.10 \ --min-self-delegation=1 ``` Now your node should be present ``` kujirad query staking validator $(kujirad keys show $KUJIRA_WALLET_ADDRESS --bech val -a) ``` or JSON output ``` kujirad query staking validators --limit 1000000 -o json | jq '.validators[] | select(.description.moniker=="${MONIKER_NAME}")' ``` Please remember to also back up `$HOME/.kujira/config/priv_validator_key.json`. If you lose this, you are toast. ## Tips ### Disk utilization To help manage the disk size you can prune the blocks being kept. for this I use prime numbers pick your own in `app.toml` ``` pruning = "custom" # These are applied if and only if the pruning strategy is custom. pruning-keep-recent = "809" pruning-keep-every = "0" pruning-interval = "43" ``` You should also check what you are indexing ``` index-events = ["tx.hash", "tx.height"] ``` ### Adding more peers You should modify `/etc/security/limits.conf` and add ``` * soft nofile 65535 * hard nofile 65535 ``` You can then modify the config.toml to increase connections. This may cost you more in ingress/egress charges. ``` max_open_connections = 1900 max_num_inbound_peers = 50 max_num_outbound_peers = 50 ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.kujira.app/validators/run-a-node.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.