Running Your Validator

Pull The Docker Image

Download the Docker image for the Testnet v3 validator by running the following docker command:

Copy

docker pull elixirprotocol/validator:v3

Start Your Validator

Run the validator by executing the following docker command, replacing /path/to/validator.env with the full path to the validator environment file you created in the Validator Setup step:

Copy

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

Optional: Setting A Restart Policy For Your Validator

Docker allows you to configure a restart policy for docker containers. Elixir recommends running your validator as a daemon with the unless-stopped restart policy:

Copy

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

Optional: Running A Validator On Apple/ARM Silicon

If you are running on a non-x86 architecture, you may need to set the --platform flag appropriately when starting the validator docker image:

Copy

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

Optional: Exposing Health Checks and Metrics

The validator image exposes HTTP endpoints for running health checks and exposes metrics suitable for monitoring with Prometheus. To access this endpoint, you must open port 17690 on the docker container. Doing so will allow you to view the /health and /metrics endpoints in the container.

Copy