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