# 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:
- Git (opens new window)
>=2
. - Make (opens new window)
>=4
- Go (opens new window)
>=1.19
# 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