Skip to main content
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.
1

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.
2

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.
3

Start the node

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

​
Option B — Raw initiad (manual)

1

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
2

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
3

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.
4

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"
5

(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.