Get started
System requirements

System Requirements

Supported Operating Systems

Madara is designed to work seamlessly on a variety of modern 64-bit operating systems. Our support encompasses but is not limited to:

Linux

  • Alpine (3.15 and newer)
  • CentOS (Stream 8 and newer)
  • Debian (10 and newer)
  • Fedora (37 and newer)
  • openSUSE (15.4 and newer)
  • RHEL (8 and newer)
  • SLES (15 and newer)
  • Ubuntu (18.04 and newer)
ℹ️

Madara does not currently support the AArch64 (ARM64) architecture for Windows.

Hardware Requirements

For optimal performance of Madara, the following hardware configurations are recommended:

NetworkMemoryCPU Cores
Mainnet16 GB8
Testnet (Sepolia)8 GB4
Appchains8 GB4

Disk Requirements

The Madara client uses a RocksDB (opens in a new tab) key-value storage.

A Madara full node requires at least 256 GB of fast disk storage, such as NVMe or a high-speed SSD, to function properly. We recommend 512 GB for reduced maintenance and greater peace of mind. For specific disk recommendations, consider referring to expert reviews and guides in the context of the Starknet network.

Database Growth

⚠️

Since the state of your network keeps growing, it is important to plan for slightly more storage than necessary to avoid maintenance.

Upon a fresh synchronization with Starknet mainnet, Madara requires around 256 GB of disk space, and this requirement will increase as the blockchain expands. Post-sync, expect the database to grow by approximately 2 GB weekly. To manage this, periodic resyncing or pruning may be necessary. A larger disk reduces the frequency of this maintenance, providing a buffer for chain growth.

Disk Speed

For Madara nodes, disk speed is a critical performance factor. We recommend using disks with a minimum of 10,000 IOPS for read and write operations to avoid sync bottlenecks and ensure swift operation.

Sync Modes and Disk Usage

The sync mode selected for Madara can greatly affect disk usage:

  • Archive Node: This retains the entire blockchain history and requires substantial storage.
  • Pruned Node: Madara will allow for older block information to be pruned to save space while still supporting the essential functionality of the network (not supported yet).

For further details, it's advisable to refer to the specific documentation regarding Madara' implementation of these modes.

⚠️

Madara currently supports Full node mode only in production.