# 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/v5.0.0/regen-ledger_5.0.0_darwin_amd64.zip

Verify the checksum:

sha256sum regen-ledger_5.0.0_darwin_amd64.zip

You should see the following:

26d07f258d489650f0dba059f6d3979f7550bf59514c0ee8f8912cca71bff1c6  regen-ledger_5.0.0_darwin_amd64.zip

Unzip the zip file:

unzip regen-ledger_5.0.0_darwin_amd64.zip

Move the binary to your local bin directory:

sudo mv regen-ledger_5.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:

v5.0.0

# For Linux Distributions

Download the zip file:

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

Verify the checksum:

sha256sum regen-ledger_5.0.0_linux_amd64.zip

You should see the following:

edbf5beaa769f971cf6b6f3c5e45cc3f38ac7d5b9dd005cddc821ccc37771155  regen-ledger_5.0.0_linux_amd64.zip

Unzip the zip file:

unzip regen-ledger_5.0.0_linux_amd64.zip

Move the binary to your local bin directory:

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

Check if the installation was successful:

regen version

You should see the following:

v5.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:

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

git checkout v5.0.0

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

git checkout v4.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:

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

v5.0.0

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

v4.0.0