Full bootstrap recipe for chain osmosis-1 running osmosisd v31.0.3 – denom uosmo, snapshot service coming soon. Walks through dependencies, Go, build, init, systemd, snapshot apply and a wallet/validator walkthrough. Operated by Ledgera.
Celestia
Osmosis
Dymension
Lava*-proledgera.com endpoints below will begin resolving once the infrastructure is deployed.Ubuntu 22.04 LTS or 24.04 LTS. Root or sudo-capable user. Minimum 8 GB RAM and a recent SSD with at least 250 GB free for osmosis-1.
sudo apt update && sudo apt upgrade -y sudo apt install -y curl git wget jq lz4 unzip tar make gcc clang \ pkg-config libssl-dev build-essential ncdu htop
ver="1.26.4" cd $HOME wget "https://go.dev/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" [ ! -f ~/.bash_profile ] && touch ~/.bash_profile echo "export GOROOT=/usr/local/go" >> ~/.bash_profile echo "export GOPATH=\$HOME/go" >> ~/.bash_profile echo "export PATH=\$GOPATH/bin:\$GOROOT/bin:\$PATH" >> ~/.bash_profile source ~/.bash_profile go version
cd $HOME rm -rf osmosis git clone https://github.com/osmosis-labs/osmosis.git cd osmosis git checkout v31.0.3 make install
MONIKER="<your-moniker>"
osmosisd config chain-id osmosis-1
osmosisd config keyring-backend os
osmosisd config node tcp://localhost:26657
osmosisd init "$MONIKER" --chain-id osmosis-1
wget -O ~/.osmosisd/config/genesis.json \ https://github.com/osmosis-labs/networks/raw/main/osmosis-1/genesis.json wget -O ~/.osmosisd/config/addrbook.json \ https://snapshot-osmosis-mainnet.proledgera.com/addrbook.json
sed -i 's|minimum-gas-prices =.*|minimum-gas-prices = "0.0025uosmo"|' \ $HOME/.osmosisd/config/app.toml
sed -i 's|pruning =.*|pruning = "custom"|; s|pruning-keep-recent =.*|pruning-keep-recent = "100"|; s|pruning-interval =.*|pruning-interval = "19"|' \ $HOME/.osmosisd/config/app.toml
sed -i 's|^indexer *=.*|indexer = "null"|' \ $HOME/.osmosisd/config/config.toml
sed -i 's|prometheus = false|prometheus = true|' \ $HOME/.osmosisd/config/config.toml
SEEDS="c4e09383972980cf42d68c269fd95659f94a09b2@seed-osmosis-mainnet.proledgera.com:26656"
PEERS=$(curl -s https://snapshot-osmosis-mainnet.proledgera.com/peers.txt | tr '\n' ',' | sed 's/,$//')
sed -i.bak -E "s|^(seeds[[:space:]]+=[[:space:]]+).*$|\1\"$SEEDS\"| ; \
s|^(persistent_peers[[:space:]]+=[[:space:]]+).*$|\1\"$PEERS\"|" \
$HOME/.osmosisd/config/config.toml
sudo tee /etc/systemd/system/osmosisd.service > /dev/null <<EOF [Unit] Description=Osmosis (osmosis-1) After=network-online.target [Service] User=$USER ExecStart=$(which osmosisd) start --home $HOME/.osmosisd Restart=on-failure RestartSec=3 LimitNOFILE=65535 [Install] WantedBy=multi-user.target EOF sudo systemctl daemon-reload sudo systemctl enable osmosisd
Pruned snapshot, lz4-compressed, coming soon. Cuts initial sync time from days to minutes.
# Preserve validator state cp $HOME/.osmosisd/data/priv_validator_state.json \ $HOME/.osmosisd/priv_validator_state.json.backup # Wipe + pull latest snapshot rm -rf $HOME/.osmosisd/data osmosisd tendermint unsafe-reset-all --home $HOME/.osmosisd/ --keep-addr-book SNAP=$(curl -s https://snapshot-osmosis-mainnet.proledgera.com/latest) curl -L $SNAP | lz4 -d | tar -x -C $HOME/.osmosisd # Restore validator state mv $HOME/.osmosisd/priv_validator_state.json.backup \ $HOME/.osmosisd/data/priv_validator_state.json
sudo systemctl start osmosisd sudo journalctl -u osmosisd -f -o cat
sudo systemctl status osmosisd
osmosisd status 2>&1 | jq .SyncInfo curl -s localhost:26657/status | jq .result.sync_info
osmosisd keys add wallet osmosisd keys add wallet --recover
osmosisd q bank balances $(osmosisd keys show wallet -a)
osmosisd tx staking create-validator \
--amount=1000000uosmo \
--pubkey=$(osmosisd tendermint show-validator) \
--moniker="<your-moniker>" \
--chain-id=osmosis-1 \
--commission-rate=0.05 \
--commission-max-rate=0.20 \
--commission-max-change-rate=0.01 \
--min-self-delegation=1 \
--from=wallet --fees=5000uosmo -y
Maintained by Ledgera. Mirror to your own infrastructure for production deployments.
TAG=v31.0.3 cd ~/osmosis git fetch --all --tags git checkout $TAG make install osmosisd version sudo systemctl restart osmosisd
SNAP_RPC="https://rpc-osmosis-mainnet.proledgera.com:443"
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)
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\"|" \
$HOME/.osmosisd/config/config.toml
osmosisd tendermint unsafe-reset-all --home $HOME/.osmosisd --keep-addr-book
sudo systemctl restart osmosisd
osmosisd keys list osmosisd keys show wallet -a osmosisd keys show wallet --bech val -a
osmosisd q bank balances $(osmosisd keys show wallet -a) osmosisd tx bank send wallet <to> 1000000uosmo \ --chain-id osmosis-1 --fees 5000uosmo -y VAL=$(osmosisd keys show wallet --bech val -a) osmosisd tx staking delegate $VAL 1000000uosmo \ --from wallet --chain-id osmosis-1 --fees 5000uosmo -y osmosisd tx distribution withdraw-rewards $VAL \ --commission --from wallet --chain-id osmosis-1 --fees 5000uosmo -y
osmosisd tx staking edit-validator \
--moniker="<new-moniker>" \
--website="https://proledgera.com/" \
--chain-id=osmosis-1 --from=wallet --fees=5000uosmo -y
osmosisd tx slashing unjail --from wallet --chain-id osmosis-1 --fees 5000uosmo -y
osmosisd q slashing signing-info $(osmosisd tendermint show-validator)
osmosisd q gov proposals osmosisd tx gov vote <id> yes \ --from wallet --chain-id osmosis-1 --fees 5000uosmo -y
sudo systemctl start osmosisd sudo systemctl stop osmosisd sudo systemctl restart osmosisd sudo journalctl -u osmosisd -f -o cat
priv_validator_key.json first.sudo systemctl stop osmosisd sudo systemctl disable osmosisd sudo rm /etc/systemd/system/osmosisd.service sudo systemctl daemon-reload rm -rf $HOME/.osmosisd $HOME/osmosis sudo rm $(which osmosisd)