Elixir. Installing the node

Main
Knowledge base
Elixir. Installing the node

12.09.2024, 15:08

Elixir Node is part of a decentralized protocol used to automate marketmaking on various trading platforms (CEX and DEX). It helps to provide liquidity on trading pairs, offering transparent and automated solutions for different projects and users. To install and work with the Elixir node, you need to follow a number of steps.

Preparing to install the Elixir node

Equipment requirements

For stable operation of the Elixir validator you will need:

RAM: minimum 8 GB
Internet: stable connection with a speed of at least 100 Mbps
Storage: minimum 100 GB
CPU: any processor that can run stably 24/7

Software

Operating system: Linux, macOS or Windows (Linux is recommended for greater stability).
Docker: you need to install Docker to manage containers.

Docker installation

To run the Elixir node, you need to install Docker. Follow the instructions for your operating system:

Ubuntu/Linux:

sudo apt update
sudo apt install docker.io
sudo systemctl start docker
sudo systemctl enable docker

MacOS: Install Docker Desktop through the official website.
Windows: also install Docker Desktop through the official website.

To verify the installation:

docker --version

Wallet generation for the validator

To work with the Elixir network, you need a unique wallet with which to sign transactions.

Install the Metamask extension and create a new account.
Save the private key of your new account. This is necessary to configure the validator.

Validator setting

Create an environment file (for example, validator.env) in which you must enter the following information:

STRATEGY_EXECUTOR_DISPLAY_NAME — The public name of the validator displayed on the Elixir dashboard.
STRATEGY_EXECUTOR_BENEFICIARY — the address of the wallet to which rewards will be received.
SIGNER_PRIVATE_KEY — private key from the wallet created earlier.

Loading a Docker image and running a node

Download the Docker image of the Elixir node and start the customization container:

Download an image of the node:

docker pull elixirprotocol/validator:v3

Start the container by specifying the environment file:

docker run -d \
  --env-file /path/to/validator.env \
  --name elixir \
  elixirprotocol/validator:v3

Additional settings

Auto restart node: To have the validator automatically restart when the system crashes or reboots, use the --restart unless-stopped flag:

docker run -d \
  --env-file /path/to/validator.env \
  --name elixir \
  --restart unless-stopped \
  elixirprotocol/validator:v3

Running on ARM architecture (e.g., Apple Silicon): If you have an ARM processor, you must add the --platform linux/amd64 flag:

docker run -d \
  --env-file /path/to/validator.env \
  --name elixir \
  --platform linux/amd64 \
  elixirprotocol/validator:v3

Updating the validator

To upgrade the node to a new version, run the following commands:

Stop the current container:

docker kill elixir
docker rm elixir

Download the new version:

docker pull elixirprotocol/validator:v3

Restart the node:

docker run -d \
  --env-file /path/to/validator.env \
  --name elixir \
  --restart unless-stopped \
  elixirprotocol/validator:v3

Monitoring and updating

Monitoring: the validator can be configured to use HTTP endpoints to check health status and metrics via Prometheus. To do this, open port 17690:

docker run -d --env-file /path/to/validator.env --name elixir -p 17690:17690 elixirprotocol/validator:v3

Validator Update: If you need to update the node, run the following commands:

docker kill elixir
docker rm elixir
docker pull elixirprotocol/validator:v3
docker run --name elixir --env-file validator.env --platform linux/amd64 -p 17690:17690 --restart unless-stopped elixirprotocol/validator:v3

Work with node

Once the node is installed and running, you can start working with Elixir, participating in providing liquidity and receiving rewards for your validator work. Keep an eye on the updates and update the node in time for correct work in the network.