# 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.

The regen binary can be installed using a pre-built package or by building and installing the binary from source. We recommend basic users install regen using the pre-built package for convenience, which does not require additional dependencies such as Git, Make, and Go.

Experimental App Configuration

Users wanting to interact with Hambach Testnet will need to build and install from source using the EXPERIMENTAL option. See Building From Source for more information.

# Pre-Built Package

# For Mac OS

Download the zip file:

curl -LO https://github.com/regen-network/regen-ledger/releases/download/v3.0.0/regen-ledger_3.0.0_darwin_amd64.zip

Verify the checksum:

sha256sum regen-ledger_3.0.0_darwin_amd64.zip

You should see the following:

4b33d7ae45a0de5745b6c23da79b4ef466af3a9ee7cc2b6501d485db4fe8589e  regen-ledger_3.0.0_darwin_amd64.zip

Unzip the zip file:

unzip regen-ledger_3.0.0_darwin_amd64.zip

Move the binary to your local bin directory:

sudo mv regen-ledger_3.0.0_darwin_amd64/regen /usr/local/bin

Open a new terminal window and check if the installation was successful:

regen version

You should see the following:

v3.0.0

# For Linux Distributions

Download the zip file:

curl -LO https://github.com/regen-network/regen-ledger/releases/download/v3.0.0/regen-ledger_3.0.0_linux_amd64.zip

Verify the checksum:

sha256sum regen-ledger_3.0.0_linux_amd64.zip

You should see the following:

5f297431c1e14d81319609564e392295e82c847cf78f295694961f9bded5419e  regen-ledger_3.0.0_linux_amd64.zip

Unzip the zip file:

unzip regen-ledger_3.0.0_linux_amd64.zip

Move the binary to your local bin directory:

sudo mv regen-ledger_3.0.0_linux_amd64/regen /usr/local/bin

Open a new terminal window and check if the installation was successful:

regen version

You should see the following:

v3.0.0

# Other Packages

Additional packages and checksums are available under "Assets" on the Release Page (opens new window).

# Building From Source

The following installation instructions include two options, one for installing the regen binary with the "stable app configuration" and another with the "experimental app configuration".

If you are looking to interact with features on Hambach Testnet not available on Regen Mainnet and Redwood Testnet, then you will want to use the "experimental app configuration", which means you will need to add the EXPERIMENTAL option to the make install command.

# Prerequisites

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

# Go Environment

The regen binary is installed in $(go env GOPATH)/bin. Make sure $(go env GOPATH)/bin is in your PATH if not already there (e.g. export PATH=$(go env GOPATH)/bin:$PATH).

# Installation

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 v3.0.0

Build and install the regen binary:

For the stable app configuration (used on Regen Mainnet and Redwood Testnet):

make install

For the experimental app configuration (used on Hambach Testnet):

EXPERIMENTAL=true make install

Check to make sure the installation was successful:

regen version

You should see the following:

v3.0.0