Beta Coming Summer 2025

EthNodes

Install and manage Ethereum nodes using standard Debian packages. A simpler approach that uses your operating system's native package management instead of containers or custom scripts.

Alpha project

•

Open source

•

Community-driven

Coming Summer 2025: Complete node packages for one-command setup. Individual client packages are available now for early testing. We're actively developing EthNodes and welcome your feedback and contributions.

Step 1/8

Terminal

Features

Simple Package-Based Node Setup

Install and configure individual Ethereum clients with standard package management - complete node packages coming soon.

One Command

Install Ethereum clients with simple apt commands. Individual packages available now, complete node packages coming soon.

Reproducible

All packages are built with reproducible practices for improved security and trust.

Easy Updates

Use your operating system for what it was intended for - to manage updates and dependencies automatically.

Multi-Network

Support for various networks including mainnet, hoodi, devnet, holesky, and ephemery.

Pre-Configured & Customizable

Nodes come with sensible defaults and proper systemd service configuration, while still allowing you to customize to meet your specific requirements.

Modular

Mix and match tools as needed - use packages, configuration, and node setups together or standalone to build your perfect Ethereum infrastructure.

Simple Installation

Get Started in Minutes

Five simple steps to get your Ethereum node up and running.

Alpha Release

This is an alpha release of EthNodes. Features may be incomplete or change before the final release. Currently, only the regtest network is available for testing purposes.

Choose Your Distribution

Add Repository Key

Add the EthNodes package repository key to your system

Repository Key:

sudo curl -fsSL https://eth-nodes.com/keys/ethnodes-archive-keyring.asc -o /usr/share/keyrings/ethnodes-archive-keyring.asc

Configure Repositories

Add the main and testing repositories to your sources

Main Repository:

echo "deb [arch=amd64 signed-by=/usr/share/keyrings/ethnodes-archive-keyring.asc] http://packages.eth-nodes.com/noble-main noble main" | sudo tee /etc/apt/sources.list.d/ethnodes.list

Testing Repository:

echo "deb [arch=amd64 signed-by=/usr/share/keyrings/ethnodes-archive-keyring.asc] http://packages.eth-nodes.com/noble-testing noble main" | sudo tee -a /etc/apt/sources.list.d/ethnodes.list

Required during alpha and beta phases as all network packages are available from the testing repository

Update Package Lists:

sudo apt update

Optional Dependencies

This is a temporary workaround for third-party dependencies. In future releases, these will be integrated directly into our packages.

Java Runtime (for Java-based clients like Teku and Besu):

curl -fsSL https://raw.githubusercontent.com/eth-pkg/eth-nodes/main/scripts/install-java.sh | bash

Note: This script installs Oracle JDK 21. You can view the script contents at GitHub.

.NET Runtime (for .NET-based clients like Nethermind):

curl -fsSL https://raw.githubusercontent.com/eth-pkg/eth-nodes/main/scripts/install-dotnet.sh | bash

Note: This script automatically detects your distribution and installs the appropriate .NET runtime. View the script at GitHub.

Node.js (for JavaScript-based clients like Lodestar):

curl -fsSL https://raw.githubusercontent.com/eth-pkg/eth-nodes/main/scripts/install-nodejs.sh | bash

Note: This script installs the latest Node.js LTS version. View the script at GitHub.

These dependencies are only required for specific Ethereum clients. Install only what you need based on your client selection.

Install Node

Select a network and install a complete Ethereum node

sudo apt install eth-node-regtest-full

Select Network:

Note: Currently only the regtest network is available in this alpha preview. Additional networks will be added in future releases.

Configure Node

Select clients and customize your node configuration

Execution Client

Consensus Client

Run a validator (staking)

Node Status (Optional)

Check the status of your Ethereum node services

Your Ethereum node runs as system services that you can monitor and control. Use these commands to check their status:

systemctl status eth-node-geth-regtest
systemctl status eth-node-lighthouse-regtest

Blockchain Synchronization

The regtest network is a local testing network with no synchronization time.

Note: Use the regtest network for local development and testing without needing to sync with external nodes.

View detailed installation guide

Help Us Improve

EthNodes is a community project in active development. We welcome your contributions and feedback.

Code Contributions

Help improve build scripts, add new packages, or fix bugs in the core tools.

View GitHub Issues

Package Recipes

Create and submit package recipes to add new Ethereum-related packages to the repository.

Recipe Guide

Feedback

Try the beta and let us know about your experience, bugs you encounter, or features you'd like to see.

Submit Feedback