Installation - Krews Docs

This guide is based on the official Initia docs and registry. Network details and genesis links are maintained by Initia. Refer to the Initia L1 Networks page for the latest chain IDs, endpoints, and minimum gas prices.

Quick facts

Binary: initiad
Recommended helper CLI: Weave
Mainnet Chain ID: interwoven-1
Testnet Chain ID: initiation-2
Min gas price: 0.015uinit (see Initia L1 Networks)
Genesis (Mainnet): https://storage.googleapis.com/init-common-genesis/interwoven-1/genesis.json
Genesis (Testnet): See the Networks page for the latest file.

We recommend the Weave CLI path for the simplest, interactive setup and automatic (Cosmovisor) upgrades. If you prefer manual control, use the Raw initiad path below.

Option A — Install with Weave (recommended)

Install prerequisites

Linux/macOS host (Ubuntu 22.04+ recommended).
If building Weave from source: Go 1.23+ and lz4 are required.
Otherwise, use prebuilt or Homebrew on macOS.

macOS (Homebrew):

brew install initia-labs/tap/weave

Linux: follow the instructions in the Weave repo’s README or releases page.

Initialize your node (guided)

Run the guided bootstrap and select Mainnet (interwoven-1) or Testnet (initiation-2) when prompted. The wizard also configures pruning, API endpoints, peers/seeds, and Cosmovisor if you opt in.

weave initia init

After the wizard finishes, config files live in ~/.initia/config/{app.toml,config.toml} and snapshot/state-sync (if chosen) is handled automatically.

Start the node

weave initia start

Use --detach to run in the background. Logs stream from Cosmovisor if enabled.

Option B — Raw `initiad` (manual)

Install initiad

Build from source or use a prebuilt release:

# From source (example)
sudo apt update && sudo apt install -y build-essential golang lz4
git clone https://github.com/initia-labs/initia.git
cd initia
git checkout <TAG>   # e.g., v1.x.y matching your target network
make install         # installs initiad into $GOBIN or $GOPATH/bin
initiad version

Initialize and pick network

# Choose one:
export CHAIN_ID=interwoven-1   # Mainnet
# export CHAIN_ID=initiation-2 # Testnet

initiad init my-node --chain-id $CHAIN_ID

Download the genesis file

Mainnet example:

curl -L https://storage.googleapis.com/init-common-genesis/interwoven-1/genesis.json -o $HOME/.initia/config/genesis.json

Testnet: fetch the current testnet genesis URL from the Initia L1 Networks page or the Initia Registry and place it at the same path.

Configure peers, seeds, and gas

Edit $HOME/.initia/config/config.toml:

# persistent_peers = "peer1@ip1:26656,peer2@ip2:26656"
# seeds = "seed1@ip:26656"

Edit $HOME/.initia/config/app.toml to set minimum-gas-prices:

minimum-gas-prices = "0.015uinit"

(Optional) Systemd service

sudo tee /etc/systemd/system/initiad.service >/dev/null <<'EOF'
[Unit]
Description=Initia L1 Node
After=network-online.target

[Service]
User=%i
ExecStart=$(which initiad) start
Restart=always
RestartSec=3
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable --now initiad.service
journalctl -u initiad -f

Verify sync

curl -s localhost:26657/status | jq .result.sync_info

For latest chain IDs, genesis URLs, peers/seeds, and gas price policy, check the official Initia L1 Networks page and the Initia Registry.

​Quick facts

​Option A — Install with Weave (recommended)

​Option B — Raw initiad (manual)

​Verify sync

Quick facts

Option A — Install with Weave (recommended)

Option B — Raw `initiad` (manual)

Verify sync