> For the complete documentation index, see [llms.txt](https://service.block-pro.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://service.block-pro.net/mainnet/celestia/useful-commands.md). # Useful Commands **Mainnet · `celestia`** Everyday service, key, token and validator operations on one page. Commands use the homes and service names in our installation guides. Use the `validator` account name and `file` keyring from our setup. Replace address and fee placeholders before use. Transaction confirmation remains interactive. **1 TIA = 1,000,000 utia**; keep additional funds for fees. ## Service operations ### Select service Choose celestia-appd for consensus, celestia-bridge for bridge, or celestia-light for light nodes. ```bash SERVICE=celestia-appd ``` ### Status Check the selected systemd service. ```bash sudo systemctl status "$SERVICE" --no-pager ``` ### Start Start the node. ```bash sudo systemctl start "$SERVICE" ``` ### Stop Stop the node. ```bash sudo systemctl stop "$SERVICE" ``` ### Restart Restart after a configuration change. ```bash sudo systemctl restart "$SERVICE" ``` ### Recent logs Show the last 100 log lines. ```bash sudo journalctl -u "$SERVICE" -n 100 --no-pager ``` ### Follow logs Follow logs; Ctrl+C leaves the log view. ```bash sudo journalctl -u "$SERVICE" -f ``` ### Sync status Check consensus height, block time and catching\_up. ```bash curl -fsS http://127.0.0.1:26657/status | jq '.result.sync_info' ``` ### Peer count Count consensus peers. ```bash curl -fsS http://127.0.0.1:26657/net_info | jq -r '.result.n_peers' ``` ### Free disk space Check available space. ```bash df -h "$HOME/.celestia-app" ``` ### Data size Measure consensus data usage. ```bash du -sh "$HOME/.celestia-app/data" ``` ## Key management These are celestia-app operator accounts. DA keys use `cel-key`; consensus signing keys are separate. ### Create Create an encrypted operator wallet; store its recovery phrase offline. ```bash celestia-appd keys add validator --keyring-backend file ``` ### Recover Recover an existing wallet through the interactive prompt. ```bash celestia-appd keys add validator --recover --keyring-backend file ``` ### List List local operator wallets. ```bash celestia-appd keys list --keyring-backend file ``` ### Account address Show the account address. ```bash celestia-appd keys show validator -a --keyring-backend file ``` ### Validator address Show the validator operator address. ```bash celestia-appd keys show validator --bech val -a --keyring-backend file ``` ### Rename Rename the local key and use the new name in later commands. ```bash celestia-appd keys rename validator validator-new --keyring-backend file ``` ## Tokens ### Set gas price Replace the placeholder with a gas price accepted by your network, including the utia denomination. ```bash GAS_PRICE="YOUR_GAS_PRICE_IN_UTIA" ``` ### Balance Read an account balance. ```bash celestia-appd query bank balances YOUR_ACCOUNT_ADDRESS --node http://127.0.0.1:26657 -o json ``` ### Send Send 1 TIA and review the destination before confirming. ```bash celestia-appd tx bank send validator YOUR_RECIPIENT_ADDRESS 1000000utia \ --chain-id celestia \ --node http://127.0.0.1:26657 \ --keyring-backend file \ --gas auto \ --gas-adjustment 1.5 \ --gas-prices "$GAS_PRICE" ``` ### Delegate Delegate 1 TIA to the chosen validator. ```bash celestia-appd tx staking delegate YOUR_VALOPER_ADDRESS 1000000utia \ --from validator \ --chain-id celestia \ --node http://127.0.0.1:26657 \ --keyring-backend file \ --gas auto \ --gas-adjustment 1.5 \ --gas-prices "$GAS_PRICE" ``` ### Withdraw rewards Withdraw rewards from the chosen validator. ```bash celestia-appd tx distribution withdraw-rewards YOUR_VALOPER_ADDRESS \ --from validator \ --chain-id celestia \ --node http://127.0.0.1:26657 \ --keyring-backend file \ --gas auto \ --gas-adjustment 1.5 \ --gas-prices "$GAS_PRICE" ``` ### Unbond Begin undelegating 1 TIA; the network unbonding period applies. ```bash celestia-appd tx staking unbond YOUR_VALOPER_ADDRESS 1000000utia \ --from validator \ --chain-id celestia \ --node http://127.0.0.1:26657 \ --keyring-backend file \ --gas auto \ --gas-adjustment 1.5 \ --gas-prices "$GAS_PRICE" ``` ### Transaction status Check inclusion and execution code; use an indexed endpoint if needed. ```bash celestia-appd query tx YOUR_TX_HASH --node http://127.0.0.1:26657 -o json ``` ## Validator operations ### Details Inspect status, stake, commission and jailed state. ```bash celestia-appd query staking validator YOUR_VALOPER_ADDRESS --node http://127.0.0.1:26657 -o json ``` ### Consensus public key Show the local consensus public key. ```bash celestia-appd tendermint show-validator ``` ### Set gas price Set an accepted gas price including the utia denomination. ```bash GAS_PRICE="YOUR_GAS_PRICE_IN_UTIA" ``` ### Edit name Update the public validator name. ```bash celestia-appd tx staking edit-validator \ --new-moniker "YOUR_NEW_NAME" \ --from validator \ --chain-id celestia \ --node http://127.0.0.1:26657 \ --keyring-backend file \ --gas auto \ --gas-adjustment 1.5 \ --gas-prices "$GAS_PRICE" ``` ### Commission and rewards Withdraw your validator commission and rewards. ```bash celestia-appd tx distribution withdraw-rewards YOUR_OWN_VALOPER_ADDRESS \ --commission \ --from validator \ --chain-id celestia \ --node http://127.0.0.1:26657 \ --keyring-backend file \ --gas auto \ --gas-adjustment 1.5 \ --gas-prices "$GAS_PRICE" ``` ### Unjail Use only after fixing the cause of jailing; tombstoned validators cannot unjail. ```bash celestia-appd tx slashing unjail \ --from validator \ --chain-id celestia \ --node http://127.0.0.1:26657 \ --keyring-backend file \ --gas auto \ --gas-adjustment 1.5 \ --gas-prices "$GAS_PRICE" ``` For initial registration, follow [Validator Node](/mainnet/celestia/validator-node.md). [CLI reference](https://docs.celestia.org/operate/consensus-validators/cli-reference/) · [Service management](https://docs.celestia.org/operate/maintenance/systemd/)