Practical overview
When it fits
Use it for local development and experiments with node functions or a multi-node Docker Compose setup; the README says it is not compatible with the æternity network.
Who it is for
- Developers studying the æternity node specification.
- People experimenting with chain state, peer connectivity or mining in a local node setup.
Documented uses
- Inspect the top block and chain state for a block hash.
- Read transactions held in the node's pool.
- List connected peers or try connecting to another Elixir node.
- Resume or suspend mining and mine a synchronous block.
Requirements & limits
The repository is public and identified as ISC-licensed. Its README says prebuilt Docker images are not yet published.
- The implementation is written in Elixir and requires Elixir 1.6 with Erlang/OTP 20, Rust, and libsodium 1.0.16.
- The default local HTTP API port is 4000 and the default sync port is 3015; the README documents environment-variable configuration for both.
- The repository explicitly warns against using this implementation to join the æternity network.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Start a three-node Docker Compose network
Launch the repository's documented local network of three connected nodes, with two mining.
Before you start
- Docker and Docker Compose
- The repository's Dockerfile and docker-compose.yml
Steps
Build the container from the repository with the command below.
docker build . -t elixir-nodeRun
docker-compose upfrom the repository to start the three connected nodes.
Expected outcome
A local network of three connected nodes runs, with two mining.
Guide limitations
- The repository warns that this implementation is not compatible with the æternity network and should not be used to join it.
- Prebuilt images are not published.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 16 October 2026
- Original website title
- aeternity/elixir-node · Official homepage title · retained in its source language

