Overview
Akash is an open network that allows users to securely and efficiently buy and sell computing resources. As a community-owned and managed public utility, its source code is available to everyone, with the community overseeing feature implementations.
Key Features:
- Community-Driven: Publicly available source code and community-managed decisions.
- Infrastructure as Code: Powered by SDL for complex deployments and resource control.
- Kubernetes Integration: Secure, reliable hosting platform.
- Persistent Storage: Limitless storage maintaining data integrity post-restart.
- Dedicated IP Leasing: Facilitates precise port assignments and traffic direction.
- Permissionless Deployment: Secure, censorship-resistant app deployment open to all.
- Peer-to-Peer Privacy: Ensures data privacy, payment transparency, and independence from central control.
- Supercloud Experience: Global services with significant cost savings through the 'Reverse Auction' system.
- Innovative Protocol: Built on the Cosmos SDK, secured by AKT, and achieving seamless IBC communication with Cosmos Hub.
Akash stands out as a powerful, flexible, and forward-thinking decentralized compute marketplace. By prioritizing user privacy and security, offering extensive customization options, and maintaining a community-centric approach, Akash is well-positioned to lead the way in the decentralized computing space.
Public Endpoints
| Type | Endpoint | Link |
|---|---|---|
| RPC | https://akash-mainnet-rpc.crouton.digital | |
| API | https://akash-mainnet-api.crouton.digital | |
| gRPC | akash-mainnet-grpc.crouton.digital:12890 | |
| peer | [email protected]:12856 |
Guide
This guide provides a complete and reliable setup for running an Akash mainnet node and validator. Here you’ll find everything you need - from downloading binaries and configuration files to initializing the node, managing keys, applying snapshots, and maintaining a stable validator environment. Follow the steps carefully to ensure a smooth and secure deployment on the Akash network.
Prepare
Update and install packages
sudo apt update && sudo apt upgrade -y && \ sudo apt install curl tar wget clang pkg-config libssl-dev libleveldb-dev jq build-essential bsdmainutils git make ncdu htop screen unzip bc fail2ban htop -y
Installing Go
VER="1.22.0" cd $HOME && \ wget "https://golang.org/dl/go$VER.linux-amd64.tar.gz" && \ sudo rm -rf /usr/local/go && \ sudo tar -C /usr/local -xzf "go$VER.linux-amd64.tar.gz" && \ rm "go$VER.linux-amd64.tar.gz" && \ echo "export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin" >> $HOME/.bash_profile && \ source $HOME/.bash_profile && \ go version
Binary
git clone https://github.com/akash-network/node/ akash cd akash git checkout v1.1.0 make install akash version --long | grep -e version -e commit # version: v1.1.0 # commit: 009fab027eb177e5d7ef0367f6df85d1fb212779
Initialization
Initialize the node (replace VALIDATOR_NAME with your own)
akash init VALIDATOR_NAME --chain-id akashnet-2 && \ akash config chain-id akashnet-2 && \ akash config keyring-backend os
Genesis
Download genesis
wget https://storage.crouton.digital/mainnet/akash/files/genesis.json -O $HOME/.akash/config/genesis.json
Addrbook
Download addrbook
wget https://storage.crouton.digital/mainnet/akash/files/addrbook.json -O $HOME/.akash/config/addrbook.json
Configuration
EXTERNAL_IP=$(wget -qO- eth0.me) NODE_NUMBER="1" sed -i.bak \ -e "s/\(proxy_app = \"tcp:\/\/\)\([^:]*\):\([0-9]*\).*/\1\2:$(($NODE_NUMBER + 266))58\"/" \ -e "s/\(laddr = \"tcp:\/\/\)\([^:]*\):\([0-9]*\).*/\1\2:$(($NODE_NUMBER + 266))57\"/" \ -e "s/\(pprof_laddr = \"\)\([^:]*\):\([0-9]*\).*/\1localhost:$(($NODE_NUMBER + 60))60\"/" \ -e "/\[p2p\]/,/^\[/{s/\(laddr = \"tcp:\/\/\)\([^:]*\):\([0-9]*\).*/\1\2:$(($NODE_NUMBER + 266))56\"/}" \ -e "/\[p2p\]/,/^\[/{s/\(external_address = \"\)\([^:]*\):\([0-9]*\).*/\1${EXTERNAL_IP}:$(($NODE_NUMBER + 266))56\"/; t; s/\(external_address = \"\).*/\1${EXTERNAL_IP}:$(($NODE_NUMBER + 266))56\"/}" \ -e "s/\(prometheus_listen_addr = \":\)\([0-9]*\).*/\1$(($NODE_NUMBER + 266))60\"/" $HOME/.akash/config/config.toml sed -i.bak \ -e "/\[api\]/,/^\[/{s/\(address = \"tcp:\/\/\)\([^:]*\):\([0-9]*\)\(\".*\)/\1\2:$(($NODE_NUMBER + 13))17\4/}" \ -e "/\[grpc\]/,/^\[/{s/\(address = \"\)\([^:]*\):\([0-9]*\)\(\".*\)/\1\2:$(($NODE_NUMBER + 90))90\4/}" \ -e "/\[grpc-web\]/,/^\[/{s/\(address = \"\)\([^:]*\):\([0-9]*\)\(\".*\)/\1\2:$(($NODE_NUMBER + 90))91\4/}" \ -e "/\[json-rpc\]/,/^\[/{s/\(address = \"\)\([^:]*\):\([0-9]*\)\(\".*\)/\1\2:$(($NODE_NUMBER + 85))45\4/}" \ -e "/\[json-rpc\]/,/^\[/{s/\(ws-address = \"\)\([^:]*\):\([0-9]*\)\(\".*\)/\1\2:$(($NODE_NUMBER + 85))46\4/}" $HOME/.akash/config/app.toml echo "export NODE=http://localhost:$(($NODE_NUMBER + 266))57" >> $HOME/.bash_profile && \ source $HOME/.bash_profile && \ akash config node $NODE
Create a service file
sudo tee /etc/systemd/system/akash.service > /dev/null <<EOF [Unit] Description=akash_node After=network.target [Service] User=$USER Type=simple ExecStart=$(which akash) start --home $HOME/.akash Restart=on-failure LimitNOFILE=65535 [Install] WantedBy=multi-user.target EOF
Start the node
sudo systemctl daemon-reload && \ sudo systemctl enable akash && \ sudo systemctl restart akash && \ sudo journalctl -u akash -f -o cat
Restore node from snapshot
sudo apt install lz4 -y && \ sudo systemctl stop akash && \ cp $HOME/.akash/data/priv_validator_state.json $HOME/.akash/priv_validator_state.json.backup && \ rm -rf $HOME/.akash/data && \ curl https://storage.crouton.digital/mainnet/akash/snapshots/akash_latest.tar.lz4 | lz4 -dc - | tar -xf - -C $HOME/.akash && \ mv $HOME/.akash/priv_validator_state.json.backup $HOME/.akash/data/priv_validator_state.json && \ sudo systemctl restart akash && \ sudo journalctl -u akash -f
State Sync
Restore node from state sync
SNAP_RPC="https://akash-mainnet-rpc.crouton.digital:443" && \ sudo systemctl stop akash && \ cp $HOME/.akash/data/priv_validator_state.json $HOME/.akash/priv_validator_state.json.backup && \ akash tendermint unsafe-reset-all --home $HOME/.akash --keep-addr-book && \ peers="[email protected]:12856" && \ sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$peers\"/" $HOME/.akash/config/config.toml && \ LATEST_HEIGHT=$(curl -s "$SNAP_RPC/block" | jq -r .result.block.header.height) && \ BLOCK_HEIGHT=$((LATEST_HEIGHT - 1000)) && \ TRUST_HASH=$(curl -s "$SNAP_RPC/block?height=$BLOCK_HEIGHT" | jq -r .result.block_id.hash) && \ echo "$LATEST_HEIGHT $BLOCK_HEIGHT $TRUST_HASH" && sleep 2 && \ sed -i.bak -E "s|^(enable[[:space:]]+=[[:space:]]+).*$|\1true| ; s|^(rpc_servers[[:space:]]+=[[:space:]]+).*$|\1\"$SNAP_RPC,$SNAP_RPC\"| ; s|^(trust_height[[:space:]]+=[[:space:]]+).*$|\1$BLOCK_HEIGHT| ; s|^(trust_hash[[:space:]]+=[[:space:]]+).*$|\1\"$TRUST_HASH\"| ; s|^(seeds[[:space:]]+=[[:space:]]+).*$|\1\"\"|" $HOME/.akash/config/config.toml && \ mv $HOME/.akash/priv_validator_state.json.backup $HOME/.akash/data/priv_validator_state.json && \ sudo systemctl restart akash && \ sudo journalctl -u akash -f
Upgrade Node
VER="vv1.1.0" git clone https://github.com/akash-network/node/ akash && \ cd $HOME && \ rm -rf akash && \ git clone https://github.com/akash-network/node/ akash && \ cd akash && \ git checkout tags/$VER -b $VER && \ make install && \ sudo systemctl restart akash && \ sudo journalctl -u akash -f
Delete Node
sudo systemctl stop akash && \ sudo systemctl disable akash && \ sudo rm -rf /etc/systemd/system/akash.service && \ sudo rm "$(which akash)" && \ sudo rm -rf "$HOME/.akash"
Key management
# This command generates a new wallet with a unique keypair. # Use this to create a secure, brand-new wallet for transactions. # Your wallet name = "wallet" akash keys add wallet
Validator management
akash tx staking create-validator \ --amount 10000000uakt \ --moniker "VALIDATOR_NAME" \ --identity "" \ --website "" \ --details "" \ --from wallet \ --commission-rate 0.1 \ --commission-max-rate 0.2 \ --commission-max-change-rate 0.01 \ --min-self-delegation 1 \ --pubkey $(celestia-appd tendermint show-validator) \ --chain-id akashnet-2 \ --gas auto \ --gas-adjustment 1.4 \ --gas-prices 0.0020uakt \ -y
Validator commands
# Retrieves comprehensive information regarding the validator. # This command is utilized to fetch details about the current validator, including its address, public key, and associated data. # Your wallet name = "wallet" akash q staking validator $(akash keys show wallet --bech val -a)
Onchain
# Withdraw all accumulated rewards from your account. # This command retrieves and withdraws all rewards earned from staking. # Your wallet name = "wallet" akash tx distribution withdraw-all-rewards --from wallet --chain-id akashnet-2 --gas-adjustment=1.15 --gas auto --gas-prices 0.0020uakt -y


