- install guide
- archive indexing
- upgrades
- useful commands
- monitoring
- contributions
Avalanche Node and Validator Guide
Reviewed on 2026-09-14. This is a public, copy-only runbook. It does not connect to a host, handle a wallet, sign a staking transaction, or change a running validator.
1. Choose an installation path
Avalanche publishes three current installation paths: the guided installer, a pre-built release archive, and a source build. The installer creates the node configuration and a system service; a manual installation leaves runtime supervision to the operator. Sources: official installer guide, pre-built binary guide, source-build guide.
For a reproducible source build, pin the reviewed tag and verify that it resolves to the expected commit before building:
The build prerequisites and scripts/build.sh workflow are documented by
Avalanche; the v1.15.0 tag and commit are pinned here so a moving branch is not
treated as a release. Sources: source-build guide, AvalancheGo v1.15.0.
For a pre-built Linux AMD64 installation, use the release asset named
avalanchego-linux-amd64-v1.15.0.tar.gz. Verify its detached signature and
this reviewed SHA-256 before extracting it:
Source: AvalancheGo v1.15.0 release assets.
2. Network and API baseline
AvalancheGo's HTTP API listens on 127.0.0.1:9650 by default, while the
Primary Network staking port is TCP 9651. A validator must send and receive
traffic on its staking port and have a reachable public address. Sources:
AvalancheGo configuration flags, validator requirements.
Keep a validator's API on loopback:
A dedicated RPC node may bind the HTTP API to an explicitly reviewed private interface and publish it through an authenticated or allowlisted reverse proxy. Do not expose a signing validator's API directly to the internet; the official installer warns that a public RPC listener must be protected by a firewall that admits only known clients. Sources: configuration flags, installer RPC warning.
After bootstrap, the local Primary Network endpoints are:
Source: official node guide.
3. Verify the node before staking
All three Primary Network chains must be bootstrapped before validator
registration. health.health reports the node's aggregate health, while
info.getNodeID returns the NodeID, BLS public key, and proof of possession
required for Primary Network validation. Sources: Info RPC, Health RPC, validator guide.
Verify TCP 9651 from a different network before staking; a successful local
health check is not proof that peers can dial the node. Source: validator
requirements.
4. Create the validator
Avalanche's reviewed paths are Core web, platform-cli, the Avalanche SDK, or
the Builder Console. Validator registration is a P-Chain transaction. Source:
Turn Node Into Validator.
Safe operator sequence:
- Complete the P/X/C bootstrap, health, and external TCP
9651checks above. Source: validator requirements. - Retrieve the NodeID, BLS public key, and proof of possession with
info.getNodeID. Source: Info RPC. - Open the official Core staking interface or Builder Console staking tool, select Primary Network validation, and enter the reviewed node and reward parameters. Source: official validator guide.
- Review the NodeID, stake, duration, delegation fee, reward address, start condition, and wallet network before approving the P-Chain transaction. These parameters cannot be changed and stake cannot be removed early after submission. Source: official validator warning.
- Before the start condition, confirm the NodeID through
platform.getPendingValidators; after validation begins, useplatform.getCurrentValidators. Source: official verification steps.
Refresh the current stake, duration, fee, and uptime requirements from the official validator and Helicon sources immediately before signing. The Helicon changes described in the Upgrade section apply at their documented activation boundary, not retroactively. Sources: validator guide, v1.15.0 release.
5. Protect identity
The staking certificate, staking private key, and BLS signer key define the node's validator identity. Keep their contents out of terminals, tickets, and public repositories, and never run two nodes with the same staking identity. Avalanche's backup guide identifies these files as the unique material needed to reconstruct a NodeID. Source: Backup and Restore.