Repository: fractal-bitcoin/fractald-release
Branch: master
Commit: 0ce2f00798e3
Files: 4
Total size: 4.2 KB

Directory structure:
gitextract_wnn62r0t/

├── 2025-07-13-prune-mode.md
├── README.md
└── fractald-docker/
    ├── cli.sh
    └── docker-compose.yaml

================================================
FILE CONTENTS
================================================

================================================
FILE: 2025-07-13-prune-mode.md
================================================

# 2025.07 Fractal Prune Mode Explained

## 💡 Recommended Prune Configuration

To optimize disk usage, we recommend keeping ~30GB of recent blocks. You can do this by updating your `bitcoin.conf` as follows:

```
prune=30000     # Retains ~30GB of recent blocks
txindex=0       # Required when pruning (default is 0)
```

With this configuration, the total disk usage of prune mode is expected to be around 300GB, mainly used by:

```
30G   data/blocks
191G  data/chainstate
```

## ⚠️ Important Notes on Pruning Existing Nodes

If you're enabling prune mode from an existing full node, note that:

A legacy `txindex` folder (~153GB) will remain under `data/indexes/txindex`.

- ✅ It is safe to delete this folder in prune mode
- 🧹 Manual cleanup required

This step helps reclaim significant disk space if you’re converting a full node to a pruned one.

## Fractal node v0.2.3 of prune mode enhancement

- 💾 Lowered minimum pruning height:
 Reduced from 100,000 to 10,000 — allowing nodes to prune more data and save additional disk space

👉 [View full release notes](https://github.com/fractal-bitcoin/fractald-release/releases/tag/v0.2.3)


================================================
FILE: README.md
================================================
# Fractal Bitcoin Overview

**Website:** [Fractal Bitcoin](https://fractalbitcoin.io)

## What is Fractal Bitcoin?

Fractal Bitcoin is the only Bitcoin scaling solution that uses the Bitcoin Core code itself to recursively scale unlimited layers on top of the world’s most-secure and -held blockchain.

It is the first instance of a virtualization methodology applied to Bitcoin in the world. Fractal gradually extends the Bitcoin blockchain into a scalable computing system without breaking consistency with the Bitcoin main chain.

With strong tooling and support, building on Fractal is straightforward.

## Getting Started

### System Requirements

| Node Type   | CPU     | RAM  | Storage (Mainnet)   | Storage (Testnet) |
| ----------- | ------- | ---- | ------------------- | ----------------- |
| Full Node   | 2 cores | 8 GB | 2 TB                | 300 GB            |
| Mining Node | 2 cores | 4 GB | 300 GB (prune mode) | 100 GB            |

- For more details of Prune Mode, please check: [2025.07 Fractal Prune Mode Explained](./2025-07-13-prune-mode.md)

### Installation Options

**1. Linux Binary Installation**

```
# Download and extract release
wget https://github.com/fractal-bitcoin/fractald-release/releases/download/v0.3.0/fractald-0.3.0-x86_64-linux-gnu.tar.gz
tar -zxvf fractald-0.3.0-x86_64-linux-gnu.tar.gz

# Run the daemon
cd fractald-0.3.0-x86_64-linux-gnu
mkdir data
./bin/bitcoind -datadir=./data/
```

**2. Docker Installation**

```
git clone https://github.com/fractal-bitcoin/fractald-release.git
cd fractald-release/fractald-docker
docker-compose up -d
```

## Configuration

**Testnet Setup**

Add to bitcoin.conf:

```
testnet=1
[testnet]
```

**Pruning (Space Saving)**

```
prune=10000  # Keeps ~10GB of blocks
# Pruning activates after block 10,000 since v0.2.3 (was 100,000 before).
```

## Build Fractal Bitcoin

The following are developer notes on how to build Bitcoin Core on your native platform. They are not complete guides, but include notes on the necessary libraries, compile flags, etc.

- [Dependencies](https://github.com/fractal-bitcoin/fractal/blob/main/doc/dependencies.md)
- [macOS Build Notes](https://github.com/fractal-bitcoin/fractal/blob/main/doc/build-osx.md)
- [Unix Build Notes](https://github.com/fractal-bitcoin/fractal/blob/main/doc/build-unix.md)
- [Windows Build Notes](https://github.com/fractal-bitcoin/fractal/blob/main/doc/build-windows.md)
- [FreeBSD Build Notes](https://github.com/fractal-bitcoin/fractal/blob/main/doc/build-freebsd.md)
- [OpenBSD Build Notes](https://github.com/fractal-bitcoin/fractal/blob/main/doc/build-openbsd.md)
- [NetBSD Build Notes](https://github.com/fractal-bitcoin/fractal/blob/main/doc/build-netbsd.md)
- [Android Build Notes](https://github.com/fractal-bitcoin/fractal/blob/main/doc/build-android.md)


================================================
FILE: fractald-docker/cli.sh
================================================
docker-compose exec bitcoind bitcoin-cli -datadir=/data "$@"

================================================
FILE: fractald-docker/docker-compose.yaml
================================================
version: "3"
services:
  bitcoind:
    image: fractalbitcoin/fractal:v0.3.0
    entrypoint: ["bitcoind", "-datadir=/data/"]
    healthcheck:
      test: ["CMD", "bitcoin-cli", "-datadir=/data/", "getblockchaininfo"]
    volumes:
      - ./data:/data