CLI Configuration | Akash Network - Your Guide to Decentralized Cloud

Configure the provider-services CLI with networks, wallets, and custom settings.

Prerequisites: You must have the CLI installed and configured. See the Installation Guide →

This guide covers all configuration options for the CLI.

Network Configuration

Mainnet (Production)

export AKASH_NET="https://raw.githubusercontent.com/akash-network/net/main/mainnet"
export AKASH_CHAIN_ID="akashnet-2"
export AKASH_NODE="https://rpc.akashnet.net:443"
export AKASH_GAS_PRICES="0.025uakt"
export AKASH_GAS_ADJUSTMENT="1.5"

Sandbox

export AKASH_NET="https://raw.githubusercontent.com/akash-network/net/main/sandbox"
export AKASH_CHAIN_ID="sandbox-2"
export AKASH_NODE="https://rpc.sandbox-2.aksh.pw:443"
export AKASH_GAS_PRICES="0.025uakt"
export AKASH_GAS_ADJUSTMENT="1.5"

Wallet Configuration

Set Default Wallet

export AKASH_KEYRING_BACKEND="os"
export AKASH_KEY_NAME="my-wallet"  # Replace with your wallet name
export AKASH_FROM="$AKASH_KEY_NAME"

Keyring Backend Options

os - OS-native keystore (recommended)
file - Encrypted file
test - Unencrypted (testing only)

Gas Configuration

Gas Settings

# Gas price (in uakt per unit)
export AKASH_GAS_PRICES="0.025uakt"

# Gas adjustment factor (multiply estimated gas)
export AKASH_GAS_ADJUSTMENT="1.5"

# Fixed gas amount (optional)
export AKASH_GAS="auto"

Tips

Higher gas prices = faster transaction confirmation
Gas adjustment helps avoid “out of gas” errors
auto estimates gas automatically

Custom RPC/API Endpoints

RPC Node

export AKASH_NODE="https://rpc.akashnet.net:443"

API Endpoint

export AKASH_API="https://api.akashnet.net:443"

Use Your Own Node

export AKASH_NODE="http://your-node-ip:26657"
export AKASH_API="http://your-node-ip:1317"

Persistent Configuration

Add to Shell Profile

Bash (~/.bashrc):

echo 'export AKASH_NET="https://raw.githubusercontent.com/akash-network/net/main/mainnet"' >> ~/.bashrc
echo 'export AKASH_CHAIN_ID="akashnet-2"' >> ~/.bashrc
echo 'export AKASH_NODE="https://rpc.akashnet.net:443"' >> ~/.bashrc
source ~/.bashrc

Zsh (~/.zshrc):

echo 'export AKASH_NET="https://raw.githubusercontent.com/akash-network/net/main/mainnet"' >> ~/.zshrc
echo 'export AKASH_CHAIN_ID="akashnet-2"' >> ~/.zshrc
echo 'export AKASH_NODE="https://rpc.akashnet.net:443"' >> ~/.zshrc
source ~/.zshrc

Configuration File

Create Config File (Optional)

# Create config directory
mkdir -p ~/.akash

# Create config file
cat > ~/.akash/config.yaml << EOF
chain-id: akashnet-2
node: https://rpc.akashnet.net:443
gas-prices: 0.025uakt
gas-adjustment: 1.5
keyring-backend: os
EOF

Use Config File

provider-services --config ~/.akash/config.yaml <command>

Verify Configuration

Check Current Settings

# View all environment variables
env | grep AKASH

# Test connection
provider-services query block

# Check wallet
provider-services keys list

Advanced Configuration

Timeout Settings

export AKASH_BROADCAST_MODE="sync"  # sync, async, or block
export AKASH_OUTPUT="json"          # json or text

Debug Mode

export AKASH_TRACE="true"

Next Steps

Commands Reference → - Learn all CLI commands
Common Tasks → - Practical deployment examples