Joining Mainnet

Hardware Requirements

To run a UX Node you will first need a Ubuntu server.

The recommended hardware to run an UX node will vary depending on the use case and desired functionalities of the node. For example, a significant amount of disk space can be required if the node will act as an archive node, i.e. pruning=nothing or if the node is a state-sync snapshot provider. In general, we recommend at a minimum the following specifications:

  • 2+ vCPU
  • 4+ GB RAM
  • 120+ GB SSD

At this point you should have set up your Ubuntu Server and should have SSH access. The following commands should be done in order to install a UX Node onto your server.

  1. Install the required packages & updates. Below we assume you use debian / ubuntu based OS.
# Update the system
sudo apt update
sudo apt upgrade

# Install git, gcc and make
sudo apt install git build-essential ufw curl jq --yes

  1. Install latest go: Make sure your version of go is not smaller than the one reported in go.modopen in new window

  2. Install the umeed binary onto your server

    1. Use docker image from umeed ghcropen in new window repository.
    2. Use latest release buildopen in new window.
    3. Build yourself: instructionsopen in new window
git clone --depth 1 --branch v3.0.1
cd umee && make install
umeed version
# Expected output: v3.0.1 or HEAD-ae43ccbd25c382cdfc5bcde26f21bc2002be5bf3
  1. Initialize node and create a wallet The --chain-id here does not matter since we will be overriding the default genesis.json file in the next step.
umeed init YOUR_MONIKER --chain-id umee-betanet-1
umeed keys add UMEE_WALLET_NAME

Save the outputted mnemonic phrase. There will be a wallet address and mnemonics from it. If you do not save the mnemonic at this stage, it will no longer be possible to do this. You will need it later.

If you are running a testnet node then be sure to copy the wallet address and use it in the Discord to get some test tokens.

  1. Overwriting default genesis.json file

    Once initialized, overwrite the default genesis.json file with genesis state file for the particular network that you are joining. You may retrieve the genesis state file from the UX repositoryopen in new window or another trusted source:

    Mainnet Node

cd ~/.umee/config
wget -O $HOME/.umee/config/genesis.json ""


  1. Install Cosmovisor

See UX readme#cosmovisoropen in new window for details.

  1. Add peers to CometBFT (formerly Tendermint) config;
nano ~/.umee/config/config.toml
#find and replace persistent_peers line
persistent_peers = "a9a84866786013f75138388fbf12cdfc425bd39c@,684dd9ce7746041d0453322808cc5b238861e386@,c4c425c66d2941ce4d5d98185aa90d2330de5efd@,eb42bdbd821fad7bd0048a741237625b4d954d18@,4e9f928cbbb2b0fede72e83f9489f922d7b6dc0b@,4e37887e1b9799b1eb479334eb3d0d2c458dc038@,bf38d9a0dbebb80e855c9d67c9a6cd9741913058@,b634e9a9661a0b101689e9cef3ffe16ab6669d5a@,aa52369e41030c927269cd5fbf575faa9373d249@,cd12da436528731dea70319d32927e5aa9319be5@"
  1. Create a service file to run the node
sudo tee /etc/systemd/system/umeed.service > /dev/null <<EOF
Description=Umee Daemon
ExecStart=$(which cosmovisor) start
  1. Run the node

These commands will finally start your node and it will begin running

sudo systemctl daemon-reload
sudo systemctl enable umeed
sudo systemctl start umeed

To check logs you can use this command

journalctl -u umeed -f