Skip to main content

Installation

Chain ID: osmo-test-5 | Current Node Version: 27.0.0-rc1

Install dependencies

sudo apt -q update
sudo apt -qy install curl git jq lz4 build-essential
sudo apt -qy upgrade

Install GO

ver="1.21.3" &&
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

Install with Cosmovisor

ADVANCED ROUTE

Cosmosvisor is a process manager for Cosmos SDK application binaries that monitors the governance module for incoming chain upgrade proposals. If a proposal is approved, cosmosvisor can automatically download the new binary, stop the current one, switch to the new binary, and restart the node with the new binary.

Download and build binaries

Clone Osmosis repo and build osmosisd 27.0.0-rc1

cd $HOME
git clone https://github.com/osmosis-labs/osmosis.git
cd osmosis
git checkout 27.0.0-rc1

Build binaries

make install

Prepare binaries for Cosmovisor

cd $HOME
mkdir -p ~/.osmosisd/cosmovisor/upgrades/27.0.0-rc1/bin
mv $HOME/go/bin/osmosisd ~/.osmosisd/cosmovisor/upgrades/27.0.0-rc1/bin/
sudo ln -s ~/.osmosisd/cosmovisor/genesis ~/.osmosisd/cosmovisor/current -f
sudo ln -s ~/.osmosisd/cosmovisor/current/bin/osmosisd /usr/local/bin/osmosisd -f

Download and install Cosmovisor

go install cosmossdk.io/tools/cosmovisor/cmd/cosmovisor@v1.5.0

Run node

Create service

sudo tee /etc/systemd/system/osmosisd.service > /dev/null << EOF
[Unit]
Description=osmosis node service
After=network-online.target

[Service]
User=$USER
ExecStart=$(which cosmovisor) run start
Restart=on-failure
RestartSec=10
LimitNOFILE=65535
Environment="DAEMON_HOME=~/.osmosisd"
Environment="DAEMON_NAME=osmosisd"
Environment="UNSAFE_SKIP_BACKUP=true"
Environment="PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin:~/.osmosisd/cosmovisor/current/bin"

[Install]
WantedBy=multi-user.target
EOF

Install without Cosmovisor

Download and build binaries

Clone Osmosis repo and build osmosisd 27.0.0-rc1

cd $HOME
git clone https://github.com/osmosis-labs/osmosis.git
cd osmosis
git checkout 27.0.0-rc1

Build binaries

make install

Run node

Create service

sudo tee /etc/systemd/system/osmosisd.service > /dev/null << EOF
[Unit]
Description=osmosis node service
After=network-online.target

[Service]
User=$USER
ExecStart=$(which osmosisd) start
Restart=on-failure
RestartSec=10
LimitNOFILE=65535
Environment="PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin"

[Install]
WantedBy=multi-user.target
EOF

Enable service

sudo systemctl daemon-reload
sudo systemctl enable osmosisd

Node configuration

Set config

osmosisd config chain-id osmo-test-5
osmosisd config keyring-backend os
osmosisd config node tcp://localhost:26657

Initialize the node

osmosisd init NAME_OF_YOUR_VALIDATOR --chain-id osmo-test-5

Download genesis and addrbook

curl https://config-t.noders.services/osmosis/genesis.json -o ~/.osmosisd/config/genesis.json
curl https://config-t.noders.services/osmosis/addrbook.json -o ~/.osmosisd/config/addrbook.json

Add peers

sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"6147a54c107d366c4a1eb5196cb20b3498a31d83@osmosis-t-rpc.noders.services:10656\"/" ~/.osmosisd/config/config.toml

Set minimum gas price

sed -i -e "s|^minimum-gas-prices *=.*|minimum-gas-prices = \"0.001uosmo\"|" ~/.osmosisd/config/app.toml

Set pruning

sed -i \
-e 's|^pruning *=.*|pruning = "custom"|' \
-e 's|^pruning-keep-recent *=.*|pruning-keep-recent = "100"|' \
-e 's|^pruning-keep-every *=.*|pruning-keep-every = "0"|' \
-e 's|^pruning-interval *=.*|pruning-interval = "19"|' \
~/.osmosisd/config/app.toml

Set custom ports

echo "export osmosisd_PORT="SET_YOUR_PORT"" >> $HOME/.bash_profile
# Set custom ports in app.toml
sed -i.bak -e "s%:1317%:${osmosisd_PORT}317%g" \
-e "s%:8080%:${osmosisd_PORT}080%g" \
-e "s%:9090%:${osmosisd_PORT}090%g" \
-e "s%:9091%:${osmosisd_PORT}091%g" \
-e "s%:8545%:${osmosisd_PORT}545%g" \
-e "s%:8546%:${osmosisd_PORT}546%g" \
-e "s%:6065%:${osmosisd_PORT}065%g" ~/.osmosisd/config/app.toml

# Set custom ports in config.toml file
sed -i.bak -e "s%:26658%:${osmosisd_PORT}658%g" \
-e "s%:26657%:${osmosisd_PORT}657%g" \
-e "s%:6060%:${osmosisd_PORT}060%g" \
-e "s%:26656%:${osmosisd_PORT}656%g" \
-e "s%:26660%:${osmosisd_PORT}660%g" ~/.osmosisd/config/config.toml

Start node and check logs

sudo systemctl start osmosisd && sudo journalctl -u osmosisd -f --no-hostname -o cat