> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tavchain.safeney.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Run a native node

> Install a Tavchain Testnet full node on Linux x86-64, Linux ARM64 or Windows x86-64, verify the release, and check sync before using local RPC.

Run a Tavchain Testnet full node directly on Linux or Windows. Download one bundle with the client, required libraries and testnet configuration included. You do not need a wallet or stake. For wallet or application access, use [public RPC](https://docs.tavchain.safeney.com/tavchain/connect.md).

## Download

Choose your platform from the [GitHub release](https://github.com/safeney/Tavchain/releases/tag/native-bundle-771002-1).

| Platform | Download |
| - | - |
| Linux x86-64 | [Linux x64 bundle](https://github.com/safeney/Tavchain/releases/download/native-bundle-771002-1/tavchain-testnet-771002-linux-amd64.tar.gz) |
| Linux ARM64 | [Linux ARM64 bundle](https://github.com/safeney/Tavchain/releases/download/native-bundle-771002-1/tavchain-testnet-771002-linux-arm64.tar.gz) |
| Windows x86-64 | [Windows x64 ZIP](https://github.com/safeney/Tavchain/releases/download/native-bundle-771002-1/tavchain-testnet-771002-windows-amd64.zip) |

Before running anything, follow [Verify the download](https://github.com/safeney/Tavchain/releases/download/native-bundle-771002-1/VERIFY.md) to check the release signature and your bundle's checksum.

Use an ordinary user account, persistent SSD storage, reliable outbound internet and accurate system time. Keep RPC private and leave ports 29656, 29657, 29645 and 29646 free. Disk usage grows with chain history.

## Initialize and start

Extract the bundle into a new folder and open a terminal in that folder. Keep all extracted files together.

> [tab] Linux
>
> Initialize once, then start:
>
> ```bash theme={null}
> ./tavchain-node init
> ./tavchain-node start
> ```

> [tab] Windows
>
> Open PowerShell in the extracted folder. Initialize once, then start:
>
> ```powershell theme={null}
> .\tavchain-node.ps1 init
> .\tavchain-node.ps1 start
> ```
>
> If Windows blocks the downloaded script, stop. After verifying the archive and reviewing the script, follow the release's [Windows file-blocking guidance](https://github.com/safeney/Tavchain/releases/download/native-bundle-771002-1/VERIFY.md#windows-file-blocking). Do not disable execution policy. Organization-managed restrictions may require your administrator.

Initialization creates private node identities and stores node data in `.tavchain-testnet-771002` under your user directory. It refuses an existing home instead of overwriting it. If initialization fails, retain the partial directory and see [Troubleshooting](https://docs.tavchain.safeney.com/tavchain/operate/troubleshooting.md).

Keep the terminal open while the node runs. The included configuration selects native chain `tavchaintestnet_771002-1` and EVM chain `771002`, connects outbound to public peers and keeps RPC on loopback.

## Check synchronization

Open `http://127.0.0.1:29657/status` in a browser.

Check that `node_info.network` is `tavchaintestnet_771002-1`, block height advances and `sync_info.catching_up` becomes `false`. Zero voting power is normal for a full node. Initial sync replays history and can take time.

For peer checks, local EVM RPC and reference-block comparisons, see [Monitor a node](https://docs.tavchain.safeney.com/tavchain/operate/monitoring.md).

## Stop and restart

Interrupt the node in its terminal and wait for shutdown before closing the window. Do not use Task Manager as the normal Windows shutdown procedure.

Restart with the same `start` command and home. Do not initialize again, replace genesis, delete data or run two processes against one home. Custom absolute home paths are supported; see `./tavchain-node --help` on Linux or `.\tavchain-node.ps1 help` on Windows and supply the same home on every invocation.

## Compatibility

The bundle uses client `1.8.1-tavchain.eval1-native1`. Non-validator initialization, sync, fixed-height state comparison and same-identity restart were tested on GitHub-hosted Ubuntu 24.04 x64/ARM64 and Windows Server 2022 x64. Linux graceful termination used SIGTERM; Windows used the console Ctrl+Break event. Windows browser-download file-blocking behavior was not part of that trial.

These tests do not establish validator signing or long-duration reliability. Native macOS and Windows ARM64 bundles are unavailable. Test TAV has no monetary value.

For background Linux x86-64 operation, use the [Docker guide](https://docs.tavchain.safeney.com/tavchain/operate/node-docker.md). The [systemd guide](https://docs.tavchain.safeney.com/tavchain/operate/node-service.md) covers a separate earlier client installation; do not mix its paths with this bundle.

Find [source and release authentication files](https://github.com/safeney/Tavchain/releases/tag/native-bundle-771002-1) on GitHub. The [earlier native client release](https://github.com/safeney/Tavchain/releases/tag/native-1.8.1-tavchain.eval1-native1) remains available. For configuration and ports, see [Network files and ports](https://docs.tavchain.safeney.com/tavchain/operate/network-assets.md). Contact [support@safeney.com](mailto:support@safeney.com) for help.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.