Regen Ledger Documentation

Install Regen

The regen binary serves as the node client and the application client. In other words, the regen binary can be used to both run a node and interact with it.

If you have not already, check out Command-Line Interface for an introduction.

Build From Source

The following instructions are for building and installing the regen binary from its source code. This is the recommended way for most users. If you do not have Git, Make, and Go installed, and you would prefer not to install them, you can install the regen binary using a pre-built package.

In the following examples we use the latest available version of Regen Ledger (v7.3.1), which is the same version used by node operators running Regen Mainnet and Regen Testnet.

Prerequisites

In order to build the regen binary from source, you'll need the following:

Note: Install Go 1.26.10 from Go Downloadsopen in new window, or use Go 1.27.3 or later. Go 1.21 to 1.26.9 can also download 1.26.10 automatically when you build, unless automatic toolchain switching is turned off (GOTOOLCHAIN=local, which some Linux distribution packages and Docker images set). Go 1.27.0 to 1.27.2 build with themselves instead, so update them to 1.27.3 or later.

Note: If you are new to go and installing it for the first time, make sure you include the following PATH export in your bash profile: export PATH=$(go env GOPATH)/bin:$PATH.

Source Code

Clone the regen-ledger repository:

git clone https://github.com/regen-network/regen-ledger

Change to the regen-ledger directory:

cd regen-ledger

Check out the latest stable version:

git checkout v7.3.1

Build Only

The following command only builds the regen binary. After running the command, the built binary will be available in a build directory within the current directory.

Build the regen binary:

make build

Check to make sure the build was successful:

./build/regen version

You should see the following:

v7.3.1

Are you not seeing the above?

  • Check the version of your source code using git status and try rerunning git checkout to see if there are any errors that might point to the problem.

Build and Install

The following command builds and installs the regen binary using go install under the hood. After running the command, a separate built binary (separate from the binary in your build directory) will be available in your go bin directory and therefore available globally.

Build and install the regen binary:

make install

Check to make sure the installation was successful:

regen version

You should see the following:

v7.3.1

Are you not seeing the above?

  • Check the version of your source code using git status and try rerunning git checkout to see if there are any errors that might point to the problem.
  • You may have previously installed the regen binary and placed it within /usr/local/bin. To use the version in your go bin directory, remove the regen binary from this location.

Pre-Built Package

The following instructions are for installing the regen binary using a pre-built package. Packages for different operating systems are provided as release assets included with each release.

For Linux Distributions

Option A: Standalone Binary

Download the binary:

curl -LO https://github.com/regen-network/regen-ledger/releases/download/v7.3.1/regen-ledger-7.3.1-linux-amd64

Verify the checksum:

sha256sum regen-ledger-7.3.1-linux-amd64

You should see the following:

71402f5c3465a425dc3c8cdb92df093ad44e5cf28a6f615cdeee7c4e1a0ecd7d  regen-ledger-7.3.1-linux-amd64

Move the binary to your local bin directory:

sudo mv regen-ledger-7.3.1-linux-amd64 /usr/local/bin/regen
sudo chmod +x /usr/local/bin/regen

Option B: Tarball

Download the tarball:

curl -LO https://github.com/regen-network/regen-ledger/releases/download/v7.3.1/regen-ledger-7.3.1-linux-amd64.tar.gz

Verify the checksum:

sha256sum regen-ledger-7.3.1-linux-amd64.tar.gz

You should see the following:

a31d19c26a2f202ba7a39f1e259c1ea688a3a0b1fde991af3ffe4d93eb4d2c87  regen-ledger-7.3.1-linux-amd64.tar.gz

Uncompress the tar.gz file and move the binary:

tar -xzf regen-ledger-7.3.1-linux-amd64.tar.gz
sudo mv regend /usr/local/bin/regen
sudo chmod +x /usr/local/bin/regen

Check if the installation was successful:

regen version

You should see the following:

7.3.1

Pre-built binaries report the version without the leading v. A binary built from source reports v7.3.1.

Additional Packages

Additional packages and checksums are available under "Assets" on the Release Pageopen in new window.