# ⚙️ Installing the Nibiru Binary
Instructions on building and installing the nibid binary. nibid is a command line client for the Nibiru blockchain. Nibiru users can use nibid to send transactions to the Nibiru network, query data from the chain, and run nodes. To install the nibid binary, you can either (1) download the binary from the NibiruChain/nibiru releases page (2) or build the binary directly from the source code.
# Install Option 1 | Use our bash script
Or, if you would like to get a specific version, use:
NOTE: The ! sign in the URL makes the script move the binary to /usr/local/bin after downloading it. For this, it will ask you for sudo password. If you would like to skip this, just ommit the ! sign from the URL.
# Install Option 2 | Downloading the binary
You'll need one of the darwin_ binaries if you're using MacOS and one of the linux_ binaries if you're using something like Ubuntu or WSL.
To know whether you'll need the amd64 or arm64, run one of the following commands:
Download the binary from the NibiruChain/nibiru releases (opens new window) page (the current testnet is v1.0.0). The assets are at the bottom after the release notes.
After downloading the tar file containing the binary, you'll need to unpack it. Here's an example command for unpacking the tar file.
Finally, add the nibid binary to your $PATH with one of the methods below.
# Install Option 3 | Building from the Source Code
# 2.1 — Install make and gcc
# 2.2 — Install Go
The installation process for Go depends on your OS. Nibiru is meant to build with a Unix system such as MacOS, Ubuntu, or WSL. Please install Go v1.18 using the instructions at go.dev/doc/install (opens new window). For Ubuntu, you can use:
You'll also want to set the following environment variables in your shell config (e.g. .bashrc, .zshrc).
# 2.3 — Compile the source code
To build the binary from source, begin by cloning the NibiruChain/nibiru repo.
# Post-installation
Running these commands should have made nibid available in your $PATH. You should now be able to view a list of all available commands:
If the "nibid: command not found" error message is returned, confirm that the Golang binary path is correctly configured by running the following command (or setting it in your shell config):
# Local development
Lastly, you can run the chain for local development with
After opening another terminal, you'll be able to use the full suite of nibid commands.
# Docker Engine
You'll need Docker to run commands that use external containers like make proto-gen. Instructions for installing Docker can be found here (opens new window).