This document describes how to install an Aeternity node using a release binary either by:
- Quick install;
- Manual install.
In order to install an Aeternity node manually, you need to:
- Retrieve the release binary corresponding to your platform;
- Install the required dependencies;
- Deploy the node.
Run below command to install latest version of aeternity node and follow the instructions:
bash <(curl -s https://install.aeternity.io/install.sh)
The release binaries are published on GitHub and are tested on the following platforms:
- Ubuntu 16.04.3 LTS (x86-64);
- Ubuntu 18.04 LTS (x86-64);
- macOS High Sierra 10.13 (x86-64);
- macOS Mojave 10.14 (x86-64).
- Windows 10 (x86-64)
Package dependencies are:
The package requires a libsodium v1.0.16 as libsodium.so.23
shared object/library.
Ubuntu 18.04 ships with libsodium 1.0.16, thus it can be installed with apt
package manager:
sudo apt-get install libsodium23
The Ubuntu release binaries are built with libssl1.0.0
(default Ubuntu 18.04 version is 1.1) requirement that can be installed with:
sudo apt-get install libssl1.0.0
As Ubuntu 16.04 ships with older libsodium version than required, it must be installed from source. A C compiler and related tools must be installed beforehand by running:
sudo apt-get install build-essential
then the library:
curl -O https://download.libsodium.org/libsodium/releases/libsodium-1.0.16.tar.gz
tar -xf libsodium-1.0.16.tar.gz && cd libsodium-1.0.16
./configure && make && sudo make install && sudo ldconfig
Easiest way to install dependencies is using Homebrew:
brew update
brew install openssl libsodium
The macOS package has:
- A hard dependency on OpenSSL v1.0.0 installed with Homebrew in its default path
/usr/local/opt/openssl/lib/libcrypto.1.0.0.dylib
; - A hard dependency on libsodium v1.0.16 installed with Homebrew in its default path
/usr/local/opt/libsodium/lib/libsodium.23.dylib
.
In case you have installed either of them in a non-default path, you could use symlink(s) to work around the issue. You can create those symlinks by running the following commands:
ln -s "$(brew --prefix openssl)"/lib/libcrypto.1.0.0.dylib /usr/local/opt/openssl/lib/libcrypto.1.0.0.dylib
ln -s "$(brew --prefix libsodium)"/lib/libsodium.23.dylib /usr/local/opt/libsodium/lib/libsodium.23.dylib
In the instructions below, the node is deployed in directory ~/aeternity/node
: you may prefer to deploy the node in an alternative location by amending the instructions accordingly.
It is recommended that the partition where the node directory is has at least 40 GB free: this is needed for the chain and the log files.
Open a Terminal window or get to the command line. Create a directory and unpack the downloaded package (you need to amend the directory and/or file name of the package):
mkdir -p ~/aeternity/node
cd ~/aeternity/node
tar xf ~/Downloads/aeternity-<package_version>-macos-x86_64.tar.gz
Windows support is currently experimental, some inconsistencies and limitations may apply.
You can choose between the following ways of running a node:
- Win32 (Native) - CUDA, No CLI
- WSL (Windows Subsystem for Linux) - CLI, No CUDA
Win32 binaries run as native Windows applications and support CUDA mining. CLI control of the node is not yet supported.
Installation:
- Download and extract the
.zip
file from the Github releases in a desired folder. - Create
aeternity.yaml
following the configuration instructions. - Run
<installation_path>\aeternity.exe
. - Safely close the MSYS2 console popup console that appears.
You will have to click 'Allow' in the firewall notifications that may popup on the first run.
Node configuration is similar to Linux CUDA miners. The corresponding
node/aeternity/lib
directory referred in the other docs is located in <installation_path>\usr\lib\aeternity\lib
.
WSL allows running the Linux binaries in Windows as well as controlling the node from the cli. Unfortunately it has limitations that prevent using CUDA miners. This is expected to change in the future.
For installation under WSL, follow the the dedicated document