Production infrastructure automation for Avalanche blockchains.
| Launch an Avalanche L1 | Run Primary Network Validators | |
|---|---|---|
| What | Deploy your own L1 blockchain with validators, RPC nodes, and a full service stack | Operate production Avalanche Primary Network validators |
| Features | Validators, archive + pruned RPC, eRPC load balancer (built-in), monitoring, block explorer, faucet, The Graph, ICM Relayer, Safe | Validators, staking key backup, database snapshots, near-zero-downtime migration, monitoring |
| Clouds | AWS, GCP, Azure | AWS |
| Guide | L1 Deployment | Primary Network |
Both paths support deployment via Terraform + Ansible (cloud VMs) or Kubernetes (existing clusters).
Install Terraform, Ansible, AWS CLI, Go, jq, and shellcheck — or run make setup.
- L1 blockchain — follow the L1 Deployment Guide
- Primary Network validators — follow the Primary Network Guide
configs/ Runtime config and genesis files (L1 + Primary Network)
terraform/ Provider infrastructure roots (l1/ and primary-network/)
ansible/ Deployment and operations playbooks/roles
scripts/ Operator helper scripts (l1/ and primary-network/)
tools/ Go CLIs (create-l1, initialize-validator-manager)
tests/ E2E and dry-run tests
kubernetes/ Kubernetes deployment path (Helm-based)
docs/ Guides and reference docs
- L1 Deployment — Full L1 runbook
- Primary Network — Validator deployment, snapshots, migration
- Add-ons — Blockscout, faucet, eRPC, The Graph, ICM Relayer, Safe
- Operations — Upgrades, health checks, monitoring, rolling restarts
- Troubleshooting — Common issues and fixes
- Kubernetes — Helm-based deployment alternative
- Security — Security expectations and guidelines
make help # Overview
make help-l1 # L1 commands
make help-primary # Primary Network commands
make k8s-help # Kubernetes commands
make help-all # Everything