# What is Teranode

> For the complete documentation index, see [llms.txt](https://bsvblockchain.com/docs/llms.txt).

Teranode is horizontally scalable node software for the BSV blockchain, built as separate services that can run on one host or across several.

Teranode is node software for the BSV blockchain, built to scale horizontally. It splits the work of a node into separate services that can run on one host or across several. Use this page to understand how a Teranode node is built and to find the documentation for running one.

## What Teranode is

In vertical scaling, a single node grows by getting a bigger machine, as in [SV Node](https://bsvblockchain.com/docs/nodes/sv-node/). Horizontal scaling, which the Teranode documentation describes, splits a node into microservices instead, each in charge of a part of the work. The documentation lists eight core services, among them:

- Propagation receives and forwards transactions across the network.
- Validator checks transactions against the network rules and updates their status in the UTXO (Unspent transaction output) store.
- Block Validation processes new blocks and checks them before they are added to the blockchain.
- Block Assembly creates subtrees (A batch of transaction IDs with its Merkle root, a part of the block's Merkle tree) and assembles block templates for miners.
- Blockchain manages block updates and keeps the node's copy of the blockchain.

Services talk to each other through gRPC and Kafka. The documentation states a design goal of over 1 million transactions per second, which it aims to reach by spreading the work across machines. Block Assembly and Blockchain are the exceptions: they run as one instance per node.

## Run a Teranode node

The Teranode documentation describes two setups:

- Docker on one host, for testing, joining a network or evaluating Teranode. The [teranode-quickstart](https://github.com/bsv-blockchain/teranode-quickstart) repository wraps Docker Compose in scripts for setup, start, status checks and RPC access.
- Kubernetes operator, for multi-node production deployments and horizontally scaled setups.

The quickstart supports four networks: Mainnet, testnet, teratestnet (A test network for Teranode) and regtest (A private chain on your own machine, used for local tests). The quickstart recommends 256 GB of RAM (128 GB at the minimum) and 2 TB or more of disk for a Mainnet node, and 8 GB of RAM for a regtest node. Check the [requirements table in the quickstart](https://github.com/bsv-blockchain/teranode-quickstart#prerequisites) before you pick a network.

## Find the documentation and get help

The Teranode guides, key topics and settings reference for running a node are in this section, imported from the Teranode repository. The pages for people who work on the Teranode code, such as contributing, protobuf and the Go API references, are on the Teranode documentation site:

- [Install Teranode with Docker](https://bsvblockchain.com/docs/nodes/teranode/howto/miners/docker/miners-how-to-installation/) for the step-by-step install.
- [Microservices overview](https://bsvblockchain.com/docs/nodes/teranode/topics/architecture/teranode-microservices-overview/) for how the services fit together.
- [Settings overview](https://bsvblockchain.com/docs/nodes/teranode/references/settings/) for the configuration of each service.
- [Teranode documentation site](https://bsv-blockchain.github.io/teranode/) for the developer pages.
- [Teranode repository](https://github.com/bsv-blockchain/teranode) for the source code and issues.
- [GitHub Discussions](https://github.com/bsv-blockchain/teranode/discussions) to ask a question or start a conversation.

## Related articles

To learn more about Teranode on the BSV blockchain, review these articles:

- [How BSV blockchain networks differ](https://bsvblockchain.com/docs/concepts/networks/)
- [Broadcast transactions with BSV Broadcaster](https://bsvblockchain.com/docs/guides/services/broadcasting/)