LogoLogo
  • WELCOME TO ALEPH ZERO
  • EXPLORE
    • About Aleph Zero
    • AlephBFT Consensus
    • The Economy of Aleph Zero
    • Where to Buy AZERO
    • Decentralized Governance on Aleph Zero
    • Ecosystem
    • Aleph Zero Foundation Treasury Management
    • Community
    • Glossary
    • Audit & Research Papers
  • USE
    • Wallets
    • Explorer
    • Ledger
    • Telegram Notifications
    • Aleph Zero Signer
      • General introduction
      • What does Signer do?
      • What are Sub-accounts and Sub-account paths?
      • Why is it critical to store your Secret Phrase in a safe place?
      • How to forget and restore accounts?
      • What are Networks?
      • What are Trusted apps?
    • Dashboard
      • Dashboard basics
      • Overview
    • Stake
      • Staking Basics
      • Staking Menu Overview
      • How to Start Staking with the Aleph Zero Dashboard
      • How to Start Staking With the Developer Wallet
      • How to start staking using Ledger hardware wallet
      • How to Change Nominations
      • How to Stop Staking
      • Staking Rewards
      • Validators
      • Commission and Foundation Nodes
      • Proxy Accounts
    • Validate
      • Validating Overview
      • Hardware requirements
      • Running an Aleph Node on Testnet
        • Downloading and running the node
        • Verifying your setup
        • Customizing your setup
        • Building and running from source [advanced]
          • Building from source
          • Set environment variables
          • Download DB snapshot
          • Running the binary
        • Appendix: Ports, addresses, validators, and archivists
      • Running an Aleph Node on Mainnet
        • Running the node
        • Building and running from source [advanced]
      • Setting your identity
      • Making the node validate
      • Securing your validator
      • Troubleshooting
      • Elections and Rewards Math
      • Testnet Validator Airdrop
      • Foundation Nomination Program
    • Using the EVM-layer
    • Governance
      • Token
      • Multisig Accounts
  • BUILD
    • Aleph Zero smart contracts basics
      • Setting up a Testnet account
      • Installing required tools
      • Creating your first contract
      • Deploying your contract to Aleph Zero Testnet
      • Extending your contract
    • Cross contract calls
      • Using references
      • Using dynamic calls
    • Migrating from Solidity
    • Writing e2e tests with ink-wrapper
    • Aleph Zero Signer integration
    • Front-end app: smart contract interaction
    • Security Course by Kudelski Security
      • ink! Developers Security Guideline
      • Lesson 1 - Getting started with ink!
      • Lesson 2 - Threat Assessment
      • Lesson 3 - Integer Overflow
      • Lesson 4 - Signed-integer
      • Lesson 5 - Role-Based Access Control
      • Lesson 6 - Address Validation
      • Lesson 7 - Smart Contract Control
    • Development on EVM-layer
  • PROTOCOL DETAILS
    • Shielder
      • Overview
      • Design against Bad Actors
      • Preliminaries - ZK-relations
      • Notes and Accounts
      • ZK-ID and Registrars
      • Anonymity Revokers
      • PoW Anonymity Revoking
      • Relayers
      • Deterministic Secret Management
      • SNARK-friendly Symmetric Encryption
      • SNARK-friendly Asymmetric Encryption
      • Cryptography
      • Token shortlist
      • User Wallet
      • Versioning
      • PoC
      • Version 0.1.0
      • Version 0.2.0
    • Common DEX
      • Common Whitepaper - Differences
      • Dutch Auctions
  • FAQ
  • Tutorials
    • Withdrawing coins from exchanges
      • How to withdraw your AZERO coins from KuCoin
      • How to withdraw your AZERO coins from MEXC Global
      • How to withdraw your AZERO coins from HTX
  • Setting up or restoring a wallet
    • How to set up or recover your AZERO account using Aleph Zero Signer
    • How to set up or recover your AZERO account using the official mainnet web wallet
    • How to set up or recover your AZERO account using Nova Wallet
    • How to set up or recover your AZERO account using SubWallet
    • How to set up or recover your AZERO account using Talisman
  • Staking
    • How to stake via a direct nomination using the Aleph Zero Dashboard
    • How to stake via a nomination pool using the Aleph Zero Dashboard
    • How to destroy a nomination pool via the Aleph Zero Dashboard
Powered by GitBook
On this page

Was this helpful?

  1. USE
  2. Validate
  3. Running an Aleph Node on Testnet

Customizing your setup

If the script we provide isn't flexible enough for your needs, in this section you will find more ways to customize your setup.

PreviousVerifying your setupNextBuilding and running from source [advanced]

Last updated 2 months ago

Was this helpful?

The script uses sensible defaults, so for the majority of use cases the above is all that is required to run a node as validator. However, there are a few things you can customize, should you be so inclined.

Runtime parameters

If you want to tweak more advanced parameters, you can do so by editing the env/validator_testnet(or env/archivist_testnet if you are running an archivist) file that you will find in the aleph-node-runner directory. Please note, however, that by doing so you may render your node non-functional, so proceed with care.

For the changes to take effect, you will need to re-run the script.

Custom images

If you are not happy with running the node inside docker, or want to build it yourself for other reasons, you can take a look at our .

If you have a Docker image that you would like to use in place of the one downloaded by the script, you can provide its name and tag to the image flag:

./run_node.sh --name <your node's name> --image <your_image>:<tag>

Choosing node type

By default, the node will start configured to be used as a validator. If you’re reading this guide, this is probably the desired setup. If, however, you would like to start an archivist, you can supply the --archivist flag.

The difference between the archivist and validator at the setup level is essentially the network configuration: an archivist allows RPC calls from outside (i.e. not from localhost) at the cost of only allowing safe RPC methods. Note that when running the script, you may first run it as an archivist and then switch it off and start in the validator mode.

Aleph version

The script will auto-update the version each time you run it, so there's no need to manually provide the version. This is due to the fact that running an up-to-date version of the node is crucial for being able to validate without problems.

Choosing build stages

You might choose to only fetch the required files and Docker images by running the script with the --build_only flag. When you have already downloaded the prerequisites, the script will make sure not to re-download them needlessly, so you can safely re-run it.

Disabling telemetry

The node will start with telemetry enabled by default. This is the recommended setup and makes it much easier to see the health of the nodes in the network. However, if you want to disable the telemetry, you will need to set the TELEMETRY_ENABLED variable to false.

Disabling pruning

The node will start with database pruning mode enabled by default. This is the recommended setup and makes a node use much less of its persistent memory. However, if you want to disable the pruning mode, you need to set both the PRUNING_ENABLED variable to false and you will have to manually download the appropriate DB snapshot.

much more detailed building guide